查询历史消息
提供获取用户以往与机器人对话的最近10条记录。调用本接口的前提是已经在机器人平台搭建并训练了机器人。
POST /openapi/v1/history
content-type application/json
请求参数：
{
"user_id": "current_user_id",
"timestamp": 23456789098765
}
| 参数 | 类型 | 规则 | 说明 |
|---|---|---|---|
| user_id | string | 必填 | 用户唯一标识。需确保该值与终端用户一一对应。 |
| timestamp | long | 选填 | 0：获取最近10条记录；指定值：获取该值之前的最近10条记录。 |
应答结果：
{
"code":0,
"msg":"",
"result":{
"cards":[
{
"text":"{\"text\":\"打印机坏了怎么办。\",\"type\":\"UserInputCard\",\"feedback_id\":null}",
"msg_type":"send",
"time":"2020-06-01 11:22:15",
"ts":"1590981732699",
"feedback_result":null,
"feedback_custom":null,
"type":"HistoryCard",
"feedback_id":null
},
{
"text":"{\"title\":\"报障至后勤。\",\"list\":[],\"type\":\"TitleListCard\",\"feedback_id\":\"4b157e578af94fbfaa90abcd00bb4cc7\"}",
"msg_type":"receive",
"time":"2020-06-01 11:21:58",
"ts":"1590981718459",
"feedback_result":null,
"feedback_custom":null,
"type":"HistoryCard",
"feedback_id":null
}]
}
}
返回结果为 JSON 字符串，各字段说明如下：
| JSON字段 | 类型 | 说明 |
|---|---|---|
| code | int | 结果代码。(具体见状态码说明) |
| msg | string | 详细信息，对接口请求的补充说明。 |
| result | object | 结果数据。 |
result 字段说明如下：
| JSON字段 | 类型 | 说明 |
|---|---|---|
| cards | array | 消息卡片。包含至少一条或多条消息卡片的里欸包 |
cards 字段说明如下：
| JSON字段 | 类型 | 说明 |
|---|---|---|
| text | string | 对话记录内容JSON结构字符串。 |
| msg_type | string | 消息方向。send：用户发出；receive：机器人回复； |
| time | string | 记录产生时间。 |
| ts | string | 记录产生时间戳。 |
| type | string | 卡片类型。此处固定为HistoryCard |