蓝心九问
Bot接口会话

查看会话列表

接口描述

此接口用于获取当前用户的所有会话列表。通过此接口,您可以检索并展示用户与不同 Bot 的最近20条历史对话记录,方便用户管理和回顾。

基础信息

请求地址/conversations
请求域名• 办公网域名:http://jiuwen-api.vmic.xyz/v1 • IDC域名:http://jiuwen-api.vivo.lan:8080/v1
请求方法GET

请求参数

Request Header

参数取值说明
AuthorizationBearer {{API-SECRET-KEY}} 用于验证客户端身份的 API密钥。注意:请只替换红色部分!Bearer和密钥中间有一个空格,请勿删除!

Query

参数类型是否必传默认值说明
last_idString否None当前页最后面一条记录的 ID
limitint20一次请求返回多少条聊天记录
userString是用户标识,由开发者定义规则,需保证用户标识在应用内唯一。

返回参数

字段类型是否不为空说明
limitint是
has_morebool是
dataList[Object]否

示例

Request

curl --location --request GET 'http://chato-console-test.vmic.xyz/v1/conversations?user=abc-123&last_id=&limit=20'\
--header 'Authorization: Bearer {{API-SECRET-KEY}}'

注意: 请只替换{{API-SECRET-KEY}}!Bearer和密钥中间有一个空格,请勿删除!

Response

{
  "limit": 20,
  "has_more": false,
  "data": [
    {
      "id": "10799fb8-64f7-4296-bbf7-b42bfbe0ae54",
      "name": "New chat",
      "inputs": {
          "book": "book",
          "myName": "Lucy"
      },
      "status": "normal",
      "created_at": 1679667915
    }
  ]
}

On this page