GET
https://api.dumate.cn/api/v1/sessions/{sessionId}/events
本接口用于查询会话（Session）的历史消息。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
sessionId
string
待查询的会话（Session）标识。
必选
Query 参数
limit
integer
返回消息数量上限。
可选
paginated
boolean
是否返回分页对象。true：响应为包含 messages 的对象。false：响应为消息数组。
可选
请求结构
GET /api/v1/sessions/ses_01ABC/events?limit=50&paginated=true HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
curl
curl --location --request GET "https://api.dumate.cn/api/v1/sessions/ses_01ABC/events?limit=50&paginated=true" \
--header 'Authorization: Bearer <YOUR_API_KEY>'curl
curl --location --request GET "https://api.dumate.cn/api/v1/sessions/ses_01ABC/events?paginated=false" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
messages
array
消息列表。
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
info
object {5}
消息元信息。
可选
显示子属性
隐藏子属性
id
string
消息标识。
可选
sessionID
string
会话（Session）标识。
可选
role
string
消息角色，常见值为 user、assistant。
可选
parentID
string
父消息标识。
可选
time
object {2}
消息时间信息。
可选
显示子属性
隐藏子属性
created
integer
创建时间，Unix 毫秒时间戳。
可选
completed
integer
完成时间，Unix 毫秒时间戳。
消息未完成时可能不存在。
可选
parts
array
消息片段列表。
可选
显示子属性
隐藏子属性
items
object {5}
显示子属性
隐藏子属性
id
string
片段标识。
可选
sessionID
string
会话（Session）标识。
可选
messageID
string
所属消息标识。
可选
type
string
片段类型，例如 text、reasoning、tool、file。
可选
text
string
文本内容，适用于文本类片段。
可选
hasMore
boolean
是否还有后续数据。
可能不返回该字段。
可选
nextCursor
string
下一页游标。
可能不返回该字段。
可选
JSON
{
"messages": [
{
"info": {
"id": "msg_user_01",
"sessionID": "ses_01ABC",
"role": "user",
"time": {
"created": 1786000001000
}
},
"parts": [
{
"id": "prt_user_01",
"sessionID": "ses_01ABC",
"messageID": "msg_user_01",
"type": "text",
"text": "总结本周项目风险。"
}
]
},
{
"info": {
"id": "msg_agent_01",
"sessionID": "ses_01ABC",
"role": "assistant",
"parentID": "msg_user_01",
"time": {
"created": 1786000002000,
"completed": 1786000005000
}
},
"parts": [
{
"id": "prt_agent_01",
"sessionID": "ses_01ABC",
"messageID": "msg_agent_01",
"type": "text",
"text": "本周主要有三项项目风险。"
}
]
}
],
"hasMore": false,
"nextCursor": ""
}JSON
[
{
"info": {
"id": "msg_user_01",
"sessionID": "ses_01ABC",
"role": "user",
"time": {
"created": 1786000001000
}
},
"parts": [
{
"id": "prt_user_01",
"sessionID": "ses_01ABC",
"messageID": "msg_user_01",
"type": "text",
"text": "你好"
}
]
}
]