`GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/threads/{thread_id}/events` 分页查询指定线程的历史事件列表，仅返回该线程相关的事件，支持按时间范围、事件类型等条件过滤。返回的事件结构与流式接口一致，具体字段定义请参考[会话事件结构参考](https://www.volcengine.com/docs/82379/2559583)。 ## 鉴权本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](https://www.volcengine.com/docs/82379/1298459?lang=zh)。 * API Key 鉴权，请在 [API Key 管理](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey) 页面，获取长效 API Key。 --- ## 请求参数 ### Path 参数 **session_id** `string` `必选` | 会话ID **thread_id** `string` `必选` | 线程ID ### Query 参数 > 在 URL Query String 中传入。 **event_type** `string` | 事件类型过滤按事件类型过滤，多个类型用逗号分隔，例如"user.message,agent.message" **start_time** `string` | 起始时间起始时间，ISO 8601格式，仅返回该时间之后产生的事件 **end_time** `string` | 结束时间结束时间，ISO 8601格式，仅返回该时间之前产生的事件 **limit** `integer` `默认值 20` | 分页大小分页大小，，最大值100。取值范围：[1, 100] **after_id** `string` | 分页游标分页游标，传入上一页返回的last_id，获取该ID之后的事件 ## 响应参数 **object** `string` | 对象类型对象类型，固定为`list` **data** `object[]` | 事件列表事件列表，每个元素为一个SessionEvent对象，仅包含当前线程相关事件，具体字段结构参见[会话事件结构参考](https://www.volcengine.com/docs/82379/2559583) **has_more** `boolean` | 是否有更多是否还有更多数据 **first_id** `string` | 首条ID 当前页第一条事件ID **last_id** `string` | 末条ID 当前页最后一条事件ID，用于下一页查询

火山方舟