# 查询呼叫历史记录 (queryCallDetailRecord)
#### 场景描述
查询历史记录。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/CC-Management/v1/mobileAgent/queryCallDetailRecord，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | X-APP-Key     | string | False | appKey字段，用户标识                                                 |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号 | 名称   | 参数类型                                                                                                              | 是否必选  | 说明    |
|:---|:---|:---|:---|:---|
| 1  | body | [body] | False | 请求体参数 |
   
 表3body参数结构 
| 序号  | 名称        | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|:---|
| 1   | body      | object | False | 请求体                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.1 | endTime   | string | True  | 结束时间，开始时间到结束时间不超过7天，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.2 | offset    | string | False | 分页查询偏移量，默认值0，即不需要偏移 ，非必选                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3 | limit     | string | False | 分页查询时单页最多的记录条数，默认值100，即每页显示100条，非必选                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.4 | startTime | string | True  | 起始时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.5 | caller    | string | False | 主叫号码，可选，不填写默认查询所有 长度限制：string (32)                                                                                                                                                                                                                                                                                                                                                |
| 1.6 | taskType  | string | False | 0：全部类型任务(除ITA双呼) 1：云客服双呼任务 2：查询匿名外呼任务 3：语音通知 4：ITA双呼 |
   
#### 响应说明
- **响应状态码: 200**
表4响应体参数 
| 序号       | 名称                | 参数类型            | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|:---|
| 1.1      | retCode           | string          | True  | 返回码。0表示成功，其他为失败。 1：未查询到数据 2：起止时间格式不符 4：limit或offset分页数据格式不符 12：主叫号码不可用                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.2      | retMsg            | string          | True  | 失败原因的描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.3      | result            | object          | False | 返回结果                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.3.1    | total             | number          | False | 总记录数                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.3.2    | callInfo          | array\[object\] | False | 记录列表                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.3.2.1  | callSerialNo      | string          | False | 呼叫流水号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 1.3.2.2  | caller            | string          | False | 主叫号码 长度限制：string (32)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.3.2.3  | called            | string          | False | 被叫号码 长度限制：string (32)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.3.2.4  | startTime         | string          | False | 外呼开始时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.5  | endTime           | string          | False | 通话结束时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.6  | state             | number          | False | 呼叫状态： 0：待呼叫 1：正在呼叫 2：通话中 3：通话结束 长度限制：number（1）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.3.2.7  | reasonCode        | number          | False | 通话结束原因码： 0\~65535， 0: 被叫挂机，通话结束 1：主叫挂机，通话结束 2：外呼主叫失败 3：外呼被叫失败 4：外呼主叫无应答 5：外呼被叫无应答 6：启动呼叫失败 xxx：其他异常 长度限制：number（5） 针对ITA双呼还有一些reasonCode，请参见[表5] |
| 1.3.2.8  | callData          | string          | False | 第三方自定义的呼叫数据信息 长度限制：string（1024）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.3.2.9  | callerPresent     | string          | False | 外显号码，来电显示的号码 长度限制：string（32）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.3.2.10 | alertingTime      | string          | False | 客户振铃时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.11 | talkingTime       | string          | False | 客户通话时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.12 | releaseTime       | string          | False | 客户释放时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.13 | talkDuration      | string          | False | 用户通话时长（秒）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.14 | agentAlertingTime | string          | False | 座席振铃时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.15 | agentTalkingTime  | string          | False | 座席通话时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.16 | agentReleaseTime  | string          | False | 座席释放时间，时间戳，如1572794607000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.17 | agentTalkDuration | string          | False | 座席通话时长（秒）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.3.2.18 | taskType          | string          | False | 0：全部类型任务(除ITA双呼) 1：云客服双呼任务 2：查询匿名外呼任务 3：语音通知 4：ITA双呼                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.3.2.19 | agentPresent      | string          | False | 外显号码，客户经理来电显示的号码 长度限制：string（32）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表5针对ITA双呼的reasonCode说明 
| retCode | **原因值描述**   |
|:---|:---|
| 0       | 不涉及         |
| 1       | 无法找到号码      |
| 2       | 无法路由到网络     |
| 3       | 无法路由到目的地    |
| 4       | 发送特殊消息      |
| 5       | 中继前缀出错      |
| 6       | 通道无法接入      |
| 7       | 已经建立频道      |
| 8       | 抢先占有        |
| 9       | 抢先占有保留      |
| 16      | 正常呼叫清除      |
| 17      | 用户忙         |
| 18      | 无应答         |
| 19      | 无用户应答       |
| 20      | 用户不可及       |
| 21      | 拒绝呼叫        |
| 22      | 号码已改变       |
| 23      | 重定向         |
| 25      | 交换路由错误      |
| 26      | 无用户准许       |
| 27      | 目标无序        |
| 28      | 非法号码格式      |
| 29      | 设备拒绝        |
| 30      | 状态查询        |
| 31      | 正常          |
| 34      | 路由不可达       |
| 38      | 网络状态不好      |
| 39      | 服务链接不上      |
| 40      | 链接进行中       |
| 41      | 暂时失败        |
| 42      | 设备拥塞        |
| 43      | 信息丢弃        |
| 44      | 通道无法接入      |
| 46      | 呼叫阻塞        |
| 47      | 无可用资源       |
| 49      | 品质无效        |
| 50      | 设备没预订       |
| 53      | 闭合群OCB呼出受限  |
| 55      | 闭合群ICB呼入受限  |
| 57      | 无权限发送       |
| 58      | 发送无效        |
| 62      | 等级不一致       |
| 63      | 服务无效        |
| 65      | 发送无法执行      |
| 66      | 通道无法执行      |
| 69      | 设备无效        |
| 70      | 发送有效        |
| 79      | CV服务没设置     |
| 81      | 引用非法值       |
| 82      | 通道不存在       |
| 83      | ID不存在       |
| 84      | 呼叫ID不存在     |
| 85      | 无呼叫等待       |
| 86      | 隐藏号码呼叫      |
| 87      | CUG无成员      |
| 88      | 目标冲突        |
| 90      | CUG不存在      |
| 91      | 无效网络        |
| 95      | 无效信息        |
| 96      | 非托管元素       |
| 97      | 类型不存在       |
| 98      | 信息没执行       |
| 99      | 信息单元不存在     |
| 100     | 无效的信息单元     |
| 101     | 呼叫状态不一致     |
| 102     | 定时器超时       |
| 103     | 参数不存在       |
| 110     | 消息中带有未识别的参数 |
| 111     | 协议错误        |
| 127     | 未指定的交互      |
   
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 报文样例
请求头:
```
x-app-key:9******************************3
Authorization:Bearer e******************************e
Content-Type:application/json
```
请求参数:
```
{
"startTime": "1562786332000",
"endTime": "1563391072000",
"taskType": "0",
"offset": "0",
"limit": "10"
}
```
响应头:
```
{
"connection": "keep-alive",
"content-type": "application/json;charset=UTF-8"
}
```
响应参数:
```
{
"result": {
"total": 11,
"callInfo": [{
"releaseTime": 1621577022000,
"called": "88889060",
"callerPresent": "640003",
"agentAlertingTime": 1621576992000,
"agentPresent": "640060",
"talkingTime": 1621576995000,
"alertingTime": 1621576994000,
"caller": "88889050",
"agentTalkingTime": 1621576994000,
"agentReleaseTime": 1621577022000,
"agentTalkDuration": 27,
"callSerialNo": "1037058396471308289",
"startTime": 1621576992000,
"endTime": 1621577022000,
"talkDuration": 26,
"state": 3,
"reasonCode": 1
}]
},
"retCode": "0",
"retMsg": "Query call detail record successfully"
}
```