GET /v1/conversations?user=<UID>&limit=20&last_id=<CID>&sort_by=-updated_at
Authorization: Bearer {API_KEY}
{
"user": "abc-123", // string,必填。终端用户标识;注意:Service API 与 WebApp 会话相互隔离
"last_id": null, // string,选填。分页游标:上一页最后一条记录的 id;第一页可不传
"limit": 20, // int,选填。每页条数,默认 20,范围 1~100
"sort_by": "-updated_at" // enum,选填。排序字段:created_at | -created_at | updated_at | -updated_at
}
成功响应
{
"limit": 20, // 本次返回条数(或你传入的 limit)
"has_more": true, // 是否还有更多(用于继续滚动分页)
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", // 会话 ID(用于 /messages 等接口)
"name": "对话标题", // 会话名称(可能为空或由系统生成)
"inputs": {}, // 该会话的应用入参快照(如有)
"status": "active", // 会话状态(字符串)
"introduction": "开场白/简介", // 应用配置的开场文案(如有)
"created_at": 1723702000, // 创建时间(秒级时间戳)
"updated_at": 1723702400 // 最近更新时间(秒级时间戳)
}
]
}