# ITA双呼结果通知（statusnotify）
#### 场景描述
提供给ITA侧调用，在呼叫结束后ITA调用此接口向AICC推送双呼话单数据。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/ita/twopartiescall/statusnotify，例如域名是service.besclouds.com
HTTPS采用TLS1.2及以上版本，确保web应用的敏感数据在传输过程中不被非法截获
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|:---|
| 1  | AppKey        | string | False | ITA侧的appKey字段，用户标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2  | Host          | string | True  | 指定请求资源的Internet主机和端口号。 - hostname：axb服务IP或域名  - port：端口号。   |
| 3  | Content-Type  | string | True  | 用于指明发送给接收者(即服务器端)的实体正文的媒体类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 4  | X-Sdk-Date    | string | True  | 发起请求的时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 5  | Authorization | string | True  | 鉴权字段，具体鉴权说明请参见ITA文档                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   
表2请求体参数 
| 序号 | 名称               | 参数类型   | 是否必选  | 说明                                                                                                                                    |
|:---|:---|:---|:---|:---|
| 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 
{ 
}
```