GET /v1/messages?conversation_id=<CID>&user=<UID>&limit=20&first_id=<MID>
Authorization: Bearer {API_KEY}
Query 参数(按文档):
{
"conversation_id": "", // string,必填。会话ID(来自 /chat-messages 返回)
"user": "", // string,必填。终端用户标识,需与创建会话时一致
"first_id": null, // string,可选。本页“第一条消息”的ID(倒序分页游标);null 表示第一页
"limit": 20 // int,可选。每页条数,默认 20,超过系统限制会按系统上限返回
}
标准响应(结构示例 + 注释)
{
"data": [
{
"id": "", // 本条消息ID
"conversation_id": "", // 会话ID
"inputs": {}, // 用户输入参数(如果应用定义了 inputs)
"query": "", // 用户输入/提问内容(属于用户消息时存在)
"message_files": [ // 本条消息关联的文件(图片等)
{
"id": "", // 文件ID
"type": "image", // 文件类型,目前对话型一般为 image
"url": "", // 预览地址(调用 /files/{file_id}/preview 访问)
"belongs_to": "user" // 文件归属:user | assistant
}
],
"answer": "", // 助手回复文本(属于助手消息时存在)
"created_at": 0, // 时间戳(秒)
"feedback": { // 反馈信息(可能不存在)
"rating": "like" // like | dislike
},
"retriever_resources": [ // RAG 引用的分段信息(可能不存在)
{
// RetrieverResource(字段因应用而异,通常含文档ID/片段/打分等)
}
]
}
],
"has_more": false, // 是否还有更早的历史
"limit": 20 // 实际返回条数(或系统限制)
}