TokenAgents / API Docs

获取聊天消息

分页读取某个聊天会话的消息列表。

POST/api/chat/messagesChat API

获取聊天消息

分页读取某个聊天会话的消息列表。

鉴权方式

需要登录态 Cookie。当前接口会读取 chatId 对应消息。

调试方式

所有页面都提供 shell curl 模板，方便你直接复制联调。

适配模型

当前页已关联 4 个模型目录，和前端实际可选模型保持同步。

请求体

当前接口支持的请求字段如下。

字段	类型	必填	说明
chatId	string	是	目标聊天 ID。
page	number	否	页码，默认 1。
limit	number	否	每页条数，默认 30。

成功返回

使用当前接口时，可参考以下返回说明。

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "list": [{"role": "user", "id": "msg_001"}],
    "total": 8,
    "page": 1,
    "limit": 30,
    "hasMore": false
  }
}

关联模型

当前接口支持的模型目录。

Kimi K2 Thinking Deepseek R1 GPT-5 Claude 4.5 Sonnet

Shell 调用示例

复制下面的 curl 模板，替换占位变量后即可联调。

curl

curl -X POST "{{baseUrl}}/api/chat/messages" \
  -H "Content-Type: application/json" \
  -H "Cookie: {{sessionCookie}}" \
  -d '{
    "chatId": "{{chatId}}",
    "page": 1,
    "limit": 30
  }'

调用说明

• 适合聊天详情页继续加载历史消息。