
# 查询转接第三方录音记录接口
#### 场景描述
查询普通IVR转第三方录音记录。
#### 接口方法
设置成"POST"。
#### URL
https://IP:PORT/oifde/rest/api/queryTransferRecordHistory
#### 请求说明
表1请求体参数 
| 参数名称       | 数据类型   | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|:---|
| tenantId   | String | body | True  | 租户ID                                                                                                                                                                                                                                                                                                                                                                       |
| authToken  | String | body | True  | 访问接口的有效Token值。 有效Token信息通过获取Token接口获取。 请参见[C3 智能助手平台接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0004.html#ZH-CN_TOPIC_0000002513073307)。 |
| beginTime  | String | body | False | 开始时间，使用UTC时间。 格式： yyyy-MM-dd HH:mm:ss                                                                                                                     |
| endTime    | String | body | False | 结束时间，使用UTC时间。 格式： yyyy-MM-dd HH:mm:ss                                                                                                                    |
| pageNum    | String | body | False | 页码 分页查询,查询第几页,首页为1 不传,默认页码为1                                                                                                                                |
| pageSize   | String | body | False | 每页多少条 可配置：5,10,20,50,100 不传,默认一页100条                                                                                                                     |
| callId     | String | body | False | 流程呼叫ID (userMobile、callId和ctiCallId需要传其中一个)                                                                                                                                                                                                                                                                                                                                |
| userMobile | String | body | False | 用户号码(userMobile、callId和ctiCallId需要传其中一个)                                                                                                                                                                                                                                                                                                                                   |
| ctiCallId  | String | body | False | 平台呼叫ID (userMobile、callId和ctiCallId需要传其中一个)                                                                                                                                                                                                                                                                                                                                |
   
#### 响应说明
表2响应体参数 
| 参数名称               | 数据类型               | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|:---|
| errorCode          | int                | body | True  | 错误码 - 0表示成功  - 非0表示失败   |
| errorMessage       | String             | body | True  | 错误描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| total              | long               | body | False | 总条数                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| transferRecordList | transferRecord\[\] | body | False | 返回转接记录列表（数组结构）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
表3transferRecord参数说明 
| 参数名称           | 数据类型   | 参数位置 | 必选/可选 | 描述                                                                                                                               |
|:---|:---|:---|:---|:---|
| id             | String | body | True  | 转接记录唯一标识                                                                                                                         |
| tenantId       | String | body | True  | 租户ID                                                                                                                             |
| callId         | String | body | True  | 流程呼叫ID                                                                                                                           |
| ctiCallId      | String | body | True  | 平台呼叫ID                                                                                                                           |
| flowInstId     | String | body | True  | 流程实例ID                                                                                                                           |
| callingNumber  | String | body | True  | 主叫号码（用户号码）                                                                                                                       |
| calledNumber   | String | body | True  | 被叫流程接入码                                                                                                                          |
| transfNumber   | String | body | True  | 转接第三方号码                                                                                                                          |
| startTime      | long   | body | True  | 通话起始时间，使用UTC时间。 格式为时间戳   |
| endTime        | long   | body | False | 通话结束时间，使用UTC时间。 格式为时间戳。 |
| recordFilePath | String | body | False | 录音文件地址                                                                                                                           |
| locationId     | String | body | True  | 录音节点,CTI POOL时有用                                                                                                                 |
| opResult       | String | body | True  | 转接结果,INIT开始转接,SUCCESS转接成功,FAIL转接失败                                                                                               |
| recordResult   | String | body | False | 录音结果,0-成功,N/A-无反馈,其他值-失败                                                                                                         |
   
#### 报文样例
- 请求消息样例
  ```
  {
  "authToken": "P********************oN1ix",
  "tenantId": "202204017094",
          "beginTime":"2022-02-21 20:04:38",
          "endTime":"",
  "pageNum": "1",
  "pageSize": "5",
  "callId": "1648805538-165717321823298",
  "userMobile": "",
  "ctiCallId": ""
  }
  ```
  
- 响应消息样例
  ```
  {
    "errorCode": 0, //接口成功失败标识    
    "errorMessage": "success!",//接口成功失败描述
    "total": 1,//总数
    "transferRecordList": [
      {
        "id": "202204013156893697",
        "tenantId": "202204017094",
        "callId": "1648805538-165717321823298",
        "ctiCallId": "1648805538-1657",
        "flowInstId": "88880301202204011732186311648805538-165717321823298",
        "callingNumber": "88880301",
        "calledNumber": "30502",
        "transfNumber": "88880302",
        "startTime": 1648805539000,
        "endTime": 1648805558000,
        "recordFilePath": "Y:/61/transferrecord/20220401/77448039.wav",
        "locationId": "0",
        "opResult": "SUCCESS",
        "recordResult": "N/A"
      }
    ]
  }
  ```
  
 
