查看消息列表

接口描述

此接口用于获取指定会话中的最近20条消息记录。您可以根据需要获取特定会话的历史消息，用于展示聊天记录或进行数据分析。

基础信息

请求地址	/messages
请求域名	• 办公网域名：`http://jiuwen-api.vmic.xyz/v1` • IDC域名：`http://jiuwen-api.vivo.lan:8080/v1`
请求方法	GET
接口说明	获取当前用户的会话列表，默认返回最近的 20 条。

请求参数

Request Header

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

Query

参数	类型	是否必填	默认值	说明
conversation_id	String	是	None	对话id
first_id	String	否	None	当前历史对话页最后面一条记录的 ID
limit	int	否	20	一次请求返回多少条聊天记录
user	String	否		用户标识，由开发者定义规则，需保证用户标识在应用内唯一。

返回参数

内容较多，详见下方示例

示例

Request

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

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

Response

{
  "limit": 10,
  "has_more": false,
  "data": [
    {
      "id": "1412443",
      "conversation_id": "1372490",
      "inputs": {},
      "query": "你好,这个图片什么内容",
      "answer": "这张图片展示了一些鸟类在水边活动的场景。前景中有一只鸟正在水中行走，而背景中可以看到几只其他鸟在水面上。",
      "middle_messages": "[]",
      "feedback": null,
      "created_at": 1758011979,
      "updated_at": 1758012000,
      "ref_link_list": [],
      "upload_media_list": [
        {
          "type": "image",
          "url": "https://gaia-mix-prd.vivo.com.cn/vision-core-prd/photo/CN01857432587600136640/tiny/446400ba51b8e82fd55a7e28da7f26d6.jpg",
          "coverUrl": null,
          "content_type": null,
          "width": 0,
          "height": 0,
          "name": null,
          "size": 0
        }
      ]
    },
    {
      "id": "1412444",
      "conversation_id": "1372490",
      "inputs": {},
      "query": "浏览器的用途",
      "answer": "浏览器是一种用于访问和浏览互联网的应用程序，其主要用途包括：\n\n1. **访问网页**：用户可以通过输入网址或搜索关键词来访问各种网站和网页。",
      "middle_messages": "[]",
      "feedback": null,
      "created_at": 1758012069,
      "updated_at": 1758012092,
      "ref_link_list": [],
      "upload_media_list": []
    }
  ]
}

查看消息列表

On this page