ITA双呼结果通知(statusnotify)
场景描述
提供给ITA侧调用,在呼叫结束后ITA调用此接口向AICC推送双呼话单数据。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/ita/twopartiescall/statusnotify,例如域名是service.besclouds.com
HTTPS采用TLS1.2及以上版本,确保web应用的敏感数据在传输过程中不被非法截获
请求说明
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
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
{
} 
