云端浏览器 API
列出会话事件
按事件序号升序读取指定会话的事件账本,包含生命周期和接管等事件,不包含页面点击或输入内容。可按 types 筛选,并将 nextCursor 原样传入读取后续页。
GET
/browser/v1/sessions/{sessionId}/events● 支持请求参数
sessionIdstring必填浏览器会话 ID;使用创建或列出会话返回的 id,以 bss_ 开头。
cursorstring可选上一页返回的 nextCursor,表示已读到的事件序号;省略时从最早事件开始。
limitinteger可选每页最多返回的记录数量;默认 50,范围 1–200。
typesstring可选逗号分隔的账本事件类型,仅返回匹配项;省略时不按类型筛选。
返回
200
错误含 statusCode、error、message;自有面另含 code。请求 ID 见 X-Request-Id。 错误
响应
HTTP 200
请求成功。
application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| 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 表示没有更多结果。 |