API Center/Inquire Single Phone Record
 

Inquire Single Phone Record

GET

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

Inquire the record information of a designated phone (for recent two months).
 
Request Parameters
voiceId
String
Required
Exclusive recording ID
 
Request Sample
Request URL:
    https://api.itniotech.com/voice/recordSip/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
sipGroupName Name of phone group String
phoneName Phone name String
callee Called number String
displayNum Display number String
code Regional operator 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 Status code 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
recordingFileId Exclusive ID of recording file String
settleRate Local currency rate (valued when the quoted currency is not USD) String
quoteExchange Client-side quoted exchange rate (valued when 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
Invoke Phone
Inquire Phone 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 recordSip() {
    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("/recordSip/").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/recordSip/".$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",
        "sipGroupName": "group1",
        "phoneName": "sipName8555",
        "callee": "91856321412",
        "displayNum": "1008122211",
        "code": "Afghanistan(Kandahar)",
        "submitTime": "2022-02-18T14:42:40+08:00",
        "callTime": "2022-02-18T14:42:45+08:00",
        "ringingTime": "2022-02-18T14:42:47+08:00",
        "answerTime": "2022-02-18T14:42:50+08:00",
        "hangupTime": "2022-02-18T14:42:55+08:00",
        "callDuration": 5,
        "chargedDuration": 5,
        "terminationCode": "1000",
        "terminationReason": "success",
        "cost": "2",
        "billPeriod": "20+20",
        "rate": "1.2",
        "recordingFileId": "3e2f0781-9642-40ec-8bbe-df35abec72d4",
        "settleRate": "1.2793",
        "quoteExchange": "0.938",
        "currency":"EUR",
        "settlePay":"1.2793"
    }
}