ITA双呼结果通知(statusnotify)
场景描述
提供给ITA侧调用,在呼叫结束后ITA调用此接口向AICC推送双呼话单数据。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/ita/twopartiescall/statusnotify,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
AppKey |
string |
False |
ITA侧的appKey字段,用户标识 |
2 |
Host |
string |
True |
指定请求资源的Internet主机和端口号。
|
3 |
Content-Type |
string |
True |
用于指明发送给接收者(即服务器端)的实体正文的媒体类型。 |
4 |
X-Sdk-Date |
string |
True |
发起请求的时间 |
5 |
Authorization |
string |
True |
鉴权字段,具体鉴权说明请参见ITA文档 |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
callID |
string |
True |
呼叫唯一标识,下载录音文件使用 |
2 |
remark |
string |
True |
来自发起呼叫时的标注。预留字段(当前信息为租间ID) |
3 |
startTime |
string |
False |
发起呼叫时间,精确到秒 格式YYYYMMDDHHmmss |
4 |
finishTime |
string |
False |
通话结束时间 |
5 |
callDuration |
string |
False |
通话时长,单位秒,供参考。 以双方通话建立开始计算 |
6 |
callerAnswerTime |
string |
False |
主叫应答时间 |
7 |
calledAnswerTime |
string |
False |
被叫应答时间 |
8 |
releaseCause |
string |
False |
呼叫结束事件携带,原因值 |
9 |
appKey |
string |
False |
客户分配资源标识 |
10 |
telA |
string |
False |
原主叫号码 |
11 |
telX |
string |
False |
落地业务号码 |
12 |
telB |
string |
False |
原被叫号码 |
13 |
calledDisplay |
string |
False |
被叫号显号码 |
响应说明
- 响应状态码: 200
收到消息后返回200 OK, 务必保证响应Content-Type为 application/json; charset=UTF-8
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
错误码
无。
报文样例
请求消息样例:
POST /twopartiescall/statusnotify HTTP/1.1 Request: AppKey: CMCCGX_0001 X-Sdk-Date: 20210512T115430Z Content-Type: application/json;charset=UTF-8 Host: 10.10.10.10:9003 Authorization: SDK-HMAC-SHA256 Access=1******2F4J8Q5T, SignedHeaders=appkey;content-type;host;x-sdk-date, Signature=77c4******62f48bcb4873e1d9ad9c1acc34b9b { "appKey": "CMCCGX_0001", "remark": "2022091800", "telA": "1580****001", "telX": "184****0497", "telB": "158****0002", "calleeDisplay": "158****0001", "startTime": "20210512115422", "callerAnswerTime": "20210512115422", "calledAnswerTime": "20210512115422", "finishTime": "20210512115430", "callID": "cmccgx20210512195422", "releaseCause": "1", "callDuration": 8 }
响应消息样例:
HTTP/1.1 200 OK Date: Mon, 12 Nov 2007 15:55:01 GMT Content-Length: xxx Content-Type: application/json; charset=UTF-8 { }