Skip to main content
get/messages
Request example
Response
get/messages

Authorization

Authorizationstringheaderrequired#

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401(unauthorized)。

Query parameters

conversation_idstringrequired#
要读取的会话 ID。会话 ID 从 获取会话列表 获取。
userstring#
终端用户标识,由你的应用定义,需在应用内唯一。参见 终端用户身份。
first_idstring#
分页游标:当前页第一条消息的 id。传入它可获取上一页(更早的消息);省略则获取最新消息。
limitinteger#
每次请求返回的聊天历史消息数量。

Default: 20

Range: 1–100

Responses

application/json
成功获取会话历史。
dataobject[]#
消息列表。
has_moreboolean#
是否有更多消息。
limitinteger#
每页条目数。