分页查询会话历史事件,返回结构同 SSE 帧的 data 。支持时间窗口过滤与排序。
前提
已创建会话,详见创建 Session。{session_id} 形如 sesn_xxx...。
接口
GET /sessions/{session_id}/events
返回结构同 SSE 帧的 data。事件信封字段含义详见订阅 Event SSE 事件流中的事件信封一节。
Query 参数
参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| string |
| 排序方向: |
| string | — | 按时间窗口过滤,ISO 8601;四个比较运算符可组合 |
| int | 20 | 每页数量,最大 100 |
| string | — | 首次不传,后续传上一次响应的 |
请求示例
响应说明
返回 data(事件 Message 对象数组,结构同 SSE 帧的 data 字段,详见订阅 Event SSE 事件流)、next_page(下一页游标,无更多数据时不返回或为 null)与 request_id。Message 对象字段如下:
响应字段
字段 | 类型 | 说明 |
|---|---|---|
| array<object> | 事件 Message 对象数组,按 |
| string | 恒为 |
| string | 事件 ID,前缀 |
| string | 事件时间戳,ISO 8601 |
| string |
|
| string | 事件类型,取值同 SSE 服务端推送事件,详见订阅 Event SSE 事件流 |
| array<object> | ContentBlock 数组,结构同发送侧 |
| object | 事件附加信息(如 |
| string | null | 下一页游标;无更多数据时不返回或为 |
| string | 本次请求的唯一标识 |