API Center/Inquire Single Voice Message Record
 

Inquire Single Voice Message Record

GET

https://api.itniotech.com/voice/recordGroup/{voiceId}

Inquire the recording information of a designated voice message (for recent two months).
 
Request Parameters
voiceId
String
Required
Exclusive recording ID
 
Request Sample
Request URL:
    https://api.itniotech.com/voice/recordGroup/2203031113381000002
Request Method:
    GET
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
 
Response Parameters
Parameters Description Type
status "0"means successful, others than 0 means failure, seeing Status Code description. String
reason Failure reason description String
data Record detail JSONObject
voiceId Exclusive recording ID String
callee Called number String
displayNum Display name String
code Operator's area String
submitTime Submitting time String
callTime Calling time String
ringingTime Ringing time String
answerTime Answering time String
hangupTime Hanging-up time String
callDuration Call duration (second) Int
chargedDuration Charged duration (second) Int
terminationCode Sip code, 200 means the call is successfully established String
terminationReason Status code description String
cost Consumption amount (Currency of quotation) String
billPeriod Billing period: 20+20, 60+60 String
rate Rate (Currency of quotation) String
baseCost Basic Cost (Currency of quotation) String
voiceFileId Exclusive ID of recording file String
feedbackValue Button feedback (-1: nothing; non-1: button) String
calledInfo Called information, 0-1000 characters String
settleRate Local currency rate (valued when the quoted currency is not USD) String
quoteExchange Client-side quoted exchange rate (valued when the quoted currency is not USD) String
settlePay Consumption amount in local currency (valued when the quoted currency is not USD) String
currency Quoted currency, EUR/USD (valued when the quoted currency is not USD) String
 
Response Status Code
status Description
0 success
-1 Authentication error
-2 Restricted IP access
-16 Timestamp expires
-18 Port program unusual
-22 Parameter exception
Inquire Phone Records by Batch
Inquire Voice Message Records by Batch

Feedback

Was this page helpful?

 

language

Java

PHP

REQUEST

import cn.hutool.core.codec.Base64;
import cn.hutool.crypto.SecureUtil;
import cn.hutool.http.Header;
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.time.LocalDateTime;
import java.time.ZoneId;

public void recordGroup() {
    final String baseUrl = "https://api.itniotech.com/voice";
    final String apiKey = "your api key";
    final String apiPwd = "your api secret";

    final String voiceId = "{{voiceId}}";

    final String url = baseUrl.concat("/recordGroup/").concat(voiceId);
    HttpRequest request = HttpRequest.get(url);

    // generate md5 key
    final String datetime = String.valueOf(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant().getEpochSecond());
    final String sign = SecureUtil.md5(apiKey.concat(apiPwd).concat(datetime));

    request.header(Header.CONTENT_TYPE, "application/json;charset=UTF-8")
            .header("Sign", sign)
            .header("Timestamp", datetime)
            .header("Api-Key", apiKey);

    HttpResponse response = request.execute();
    if (response.isOk()) {
        String result = response.body();
        System.out.println(result);
    }
}

REQUEST

header('content-type:text/html;charset=utf8');

$apiKey = "your api key";
$apiSecret = "your api secret";
$voiceId = "{{voiceId}}";

$url = "https://api.itniotech.com/voice/recordGroup/".$voiceId;

$timeStamp = time();
$sign = md5($apiKey.$apiSecret.$timeStamp);

$headers = array('Content-Type:application/json;charset=UTF-8',"Sign:$sign","Timestamp:$timeStamp","Api-Key:$apiKey");

$ch = curl_init();


curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 600);
curl_setopt($ch, CURLOPT_HTTPHEADER,$headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$output = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);

var_dump($output);
 

RESPONSEEXAMPLE

{
    "status": "0",
    "reason": "success",
    "data":{
        "voiceId": "2203031113381000002",
        "callee": "91856321412",
        "displayNum": "1008122211",
        "code": "Afghanistan(Kandahar)",
        "submitTime": "2022-01-18T14:42:40+08:00",
        "callTime": "2022-01-18T14:42:45+08:00",
        "ringingTime": "2022-01-18T14:42:47+08:00",
        "answerTime": "2022-01-18T14:42:50+08:00",
        "hangupTime": "2022-01-18T14:42:55+08:00",
        "callDuration": 5,
        "chargedDuration": 5,
        "terminationCode": "200",
        "terminationReason": "success",
        "cost": "2",
        "billPeriod": "20+20",
        "rate": "1.2",
        "baseCost": "1",
        "voiceFileId": "12022022570cc2484c59d4f8b9745d34226285b1e.mp3",
        "feedbackValue": "1",
        "settleRate": "1.2793",
        "quoteExchange": "0.938",
        "currency":"EUR",
        "settlePay":"1.2793"
    }
}