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 
{ 
}