云端浏览器 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

名称类型说明
dataarray<object>本页查询匹配的记录;没有匹配项时为空数组。
data[].seqinteger当前会话内递增的事件序号,用于事件排序及分页。
data[].idstring服务生成的事件唯一标识,使用 UUID 格式。
data[].typestring会话账本中的事件类型,用于区分状态变化和会话操作。
data[].processed_atstring事件记录时刻,UTC ISO 8601 时间。
data[].session_idstring浏览器会话 ID;使用创建或列出会话返回的 id,以 bss_ 开头。
data[].reasonstring事件发生原因;关闭相关事件记录对应的会话释放原因。
data[].payloadobject事件附加数据,内容取决于事件类型;没有附加数据时省略。
nextCursorstring | null下一页游标;原样传入 cursor,null 表示没有更多结果。