获取对话明细
最新更新:2023-11-15

获取对话明细

获取指定对话 ID 内的所有消息记录。

请求方式

GET

调用地址

https://api.gptbots.ai/v1/messages

调用验证

详情参见 API 概述的鉴权方式说明。

请求

请求示例

curl -X GET 'https://api.gptbots.ai/v1/messages?conversation_id=xxxxxx&user_id=123456&page=1&page_size=100' \ -H 'Authorization: Bearer your_apikey' \ -H 'Content-Type: application/json'
          curl -X GET 'https://api.gptbots.ai/v1/messages?conversation_id=xxxxxx&user_id=123456&page=1&page_size=100' \ 
  -H 'Authorization: Bearer your_apikey' \ 
  -H 'Content-Type: application/json'

        
此代碼塊在浮窗中顯示

请求头

字段 类型 描述
Authorization Bearer ${token} 使用 Authorization: Bearer ${token}进行调用验证,请在 API 密钥页面获取密钥作为 token。
Content-Type application/json 数据类型,取值为 application/json。

请求体

字段 类型 必填 描述
conversation_id string 对话标识符。
page int 页数,表示你想请求第几页的数据。
page_size int 每页的数据量,表示你希望每页返回多少条数据,最多 100 条。

响应

响应示例

{ "total": 100, "messages": [ { "message_id": "645dd86906931c4a9e0ffb1f", "parent_message_id": "", "message_type": "ANSWER", "text": "你好,我是一个客服机器人,你可以在这里得到问题解答", "create_time": 1683871849906 }, { "message_id": "745dd86906931c4a9e0ffb1f", "parent_message_id": "645dd86906931c4a9e0ffb1f", "message_type": "QUESTION", "text": "极光推送的功能介绍", "create_time": 1683871849906 }, { "message_id": "845dd86906931c4a9e0ffb1f", "parent_message_id": "745dd86906931c4a9e0ffb1f", "message_type": "ANSWER", "text": "极光推送是一个强大的平台。...", "create_time": 1683871849906 } ] }
          {
  "total": 100,
  "messages": [
    {
      "message_id": "645dd86906931c4a9e0ffb1f",
      "parent_message_id": "",
      "message_type": "ANSWER",
      "text": "你好,我是一个客服机器人,你可以在这里得到问题解答",
      "create_time": 1683871849906
    },
    {
      "message_id": "745dd86906931c4a9e0ffb1f",
      "parent_message_id": "645dd86906931c4a9e0ffb1f",
      "message_type": "QUESTION",
      "text": "极光推送的功能介绍",
      "create_time": 1683871849906
    },
    {
      "message_id": "845dd86906931c4a9e0ffb1f",
      "parent_message_id": "745dd86906931c4a9e0ffb1f",
      "message_type": "ANSWER",
      "text": "极光推送是一个强大的平台。...",
      "create_time": 1683871849906
    }
  ]
}

        
此代碼塊在浮窗中顯示

成功响应

字段 类型 描述
total string 本对话中的消息总数。
messages JSON Array 消息详情。
message_id string 消息的唯一标识。
parent_message_id string 本消息的父消息的唯一标识。
message_type string 消息类型,取值:ANSWER、QUESTION。
text string 消息内容。
create_time long 这条消息产生的时间戳。

失败响应

字段 类型 描述
code int 错误码。
message string 错误详情。

错误码

Code Message
40000 参数错误
40005 分页参数不能大于实际数量
40127 开发者鉴权失败
40356 会话不存在
20059 Bot 已删除