GET /api/open/sessions/{session_id}/messages — 分页获取会话历史消息

分页获取会话历史消息

更新时间：2026/08/18

API 默认按时间正序返回（旧→新）。

🔧请求信息

请求 URI

GET https://lg.jimitu.top/api/open/sessions/{session_id}/messages

请求头参数

Header	必填	说明
`Authorization`	是	Bearer {API Key}，接口鉴权，所有请求均需携带
`Content-Type`	否	仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json

请求路径参数

参数	类型	必填	说明
session_id	integer	是	会话 ID

请求查询参数

参数	类型	必填	说明
user_id	string	是	外部用户 ID，必须是会话所属或设备当前绑定的用户
page	integer	否	页码，默认 1
page_size	integer	否	每页条数，默认 20，最大 100

请求示例

curl -X GET "https://lg.jimitu.top/api/open/sessions/{session_id}/messages?user_id=<user_id>&page=1&page_size=50" \
  -H "Authorization: Bearer <your_api_key>"

📥响应信息

响应体示例

{
  "success": true,
  "data": [
    {
      "id": 9001,
      "chat_session_id": 1001,
      "character_id": 555,
      "content": "你好",
      "message_type": "text",
      "is_user": true,
      "metadata": {},
      "created_at": "2026-01-01T12:00:00Z"
    }
  ],
  "pagination": { "current_page": 1, "total_pages": 3, "total_count": 58, "has_next": true, "has_previous": false }
}

响应参数

字段	类型	说明
id	integer	消息 ID
chat_session_id	integer	所属会话 ID
character_id	integer	角色实例 ID（用户消息时为 null）
content	string	消息内容
message_type	string	消息类型（如 text）
is_user	boolean	是否用户消息
metadata	object	消息附加元数据（如 harness 过程事件；普通消息为 {}）
created_at	string	创建时间

⚠️错误码

错误码

error_code	HTTP	说明
`SESSION_NOT_FOUND`	404	会话不存在或无权访问
`INVALID_QUERY_PARAMETER`	400	查询参数格式错误或超分页上限