Cloud Browser API
List session events
Read session events with optional type filtering and cursor pagination.
GET
/browser/v1/sessions/{sessionId}/events● SupportedRequest parameters
sessionIdstring必填浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。
cursorstring可选上一页返回的 nextCursor，表示已读到的事件序号；省略时从最早事件开始。
limitinteger可选每页最多返回的记录数量；默认 50，范围 1–200。
typesstring可选逗号分隔的账本事件类型，仅返回匹配项；省略时不按类型筛选。
Returns
200
Errors contain statusCode, error and message; the native API adds code. The request ID is in X-Request-Id. Errors
Response
HTTP 200
请求成功。
application/json
| Name | Type | Description |
|---|---|---|
| data | array<object> | 本页查询匹配的记录；没有匹配项时为空数组。 |
| data[].seq | integer | 当前会话内递增的事件序号，用于事件排序及分页。 |
| data[].id | string | 服务生成的事件唯一标识，使用 UUID 格式。 |
| data[].type | string | 会话账本中的事件类型，用于区分状态变化和会话操作。 |
| data[].processed_at | string | 事件记录时刻，UTC ISO 8601 时间。 |
| data[].session_id | string | 浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。 |
| data[].reason | string | 事件发生原因；关闭相关事件记录对应的会话释放原因。 |
| data[].payload | object | 事件附加数据，内容取决于事件类型；没有附加数据时省略。 |
| nextCursor | string | null | 下一页游标；原样传入 cursor，null 表示没有更多结果。 |