# 交互记录查询接口
#### 场景描述
智能助手平台提供接口给第三方接入方调用,实现智能交互信息记录的查询,此接口只能查询用户最近一次来话的实例。
#### 接口方法
设置成"POST"。
#### URL
https://IP:PORT/oifde/rest/api/queryHistory
#### 请求说明
| 参数名称      | 数据类型                 | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|:---|
| tenantId  | String               | body | True  | 租间ID。                                                                                                                                                                                                                                                                                                                                                          |
| params    | Map\<String,Object\> | body | True  | 参数包。详情见[表1 params参数]                                                                                                                                                                                                                                      |
| authToken | String               | body | True  | 访问接口的有效Token值。 有效Token信息通过获取Token接口获取。 请参见[C3 智能助手平台接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0004.html#ZH-CN_TOPIC_0000002513073307)。 |
   
 表1params参数 
| 参数名称       | 数据类型   | 参数位置 | 必选/可选 | 描述                                    |
|:---|:---|:---|:---|:---|
| userMobile | String | body | True  | 用户标识。（语音导航、语音外呼场景传入用户号码,其他交互场景传入用户id） |
   
#### 响应说明
| 参数名称      | 数据类型                 | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|:---|
| rtnCode   | int                  | body | True  | 错误码 - 0或者null：成功  - 非0表示失败 或可通过状态码为200判断为成功    |
| rtnMsg    | String               | body | False | 错误描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| beans     | Map\<String,String\> | body | True  | 返回内容数组。详情见[表2 beans参数说明]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| callId    | String               | body | True  | 呼叫唯一标志                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| callSorId | String               | body | True  | 用户标识,与入参userMobile相同                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| object    | Object               | body | False | 默认 null(专有局点特有)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| bean      | String               | body | False | 默认 null(专有局点特有)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
 表2beans参数说明 
| 参数名称           | 数据类型   | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|:---|
| interNo        | String | body | True  | 内部序号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| userSaying     | String | body | True  | 用户和机器人交谈记录的文本                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| intention      | String | body | True  | 用户意图                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| systemReply    | String | body | True  | 系统回复                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| type           | String | body | True  | 回复类型,TTS、voice file或text                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| timestamp      | String | body | True  | 系统回复时间，使用UTC时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| responseSource | String | body | True  | 对话的回复来源 - 0：机器人回复  - 1：静默座席回复   |
   
#### 报文样例
- 请求消息样例
  ```
  {
     "tenantId":"123456",
     "params":{
        "userMobile": "180****9999" 
      },
     "authToken":"n******************************"
  }
  ```
  
- 响应消息样例
  ```
  {    
       "rtnCode": 0,//接口成功失败标识    
       "rtnMsg": "成功",//接口成功失败描述
       "beans": [{        
           "interNo":"1",    //序号        
           "userSaying":"我有多少话费",  //语音转写结果        
           "intention":"查询话费",      //用户意图        
           "systemReply":"您好,您当月累计消费100元,话费余额100元",  //系统回复
           "type":"TTS",  //回复类型
           "timestamp":"2019-04-25 17:42:10.0",  //系统回复时间
           "responseSource":"0"  //机器人回复
       }],
      "object": null,   
      "bean": null,
      "callId": "xytest02131110",
      "callSorId": "18019919999"
  }
  ```