云端浏览器 API

请求人工接管

为运行中的会话发起人工接管请求,返回接管请求事件。请求尚未过期或完成时,CDP 客户端的 Input.* 指令会被拒绝;再次请求会替换已有的接管说明和到期时刻。

POST /browser/v1/sessions/{sessionId}/handoff● 支持

请求参数

  • sessionIdstring必填

    浏览器会话 ID;使用创建或列出会话返回的 id,以 bss_ 开头。

  • messagestring必填

    交给人工操作者的接管说明,可为空字符串。

  • timeoutMsnumber可选
    默认 1800000

    接管请求有效时长,单位为毫秒;必须大于 0,可含小数。

返回

200

错误含 statusCode、error、message;自有面另含 code。请求 ID 见 X-Request-Id。 错误

连接与使用指南

响应

HTTP 200

请求成功。

application/json

名称类型说明
seqinteger当前会话内递增的事件序号,用于事件排序及分页。
idstring服务生成的事件唯一标识,使用 UUID 格式。
typestring会话账本中的事件类型,用于区分状态变化和会话操作。
processed_atstring事件记录时刻,UTC ISO 8601 时间。
session_idstring浏览器会话 ID;使用创建或列出会话返回的 id,以 bss_ 开头。
reasonstring事件发生原因;关闭相关事件记录对应的会话释放原因。
payloadobject事件附加数据,内容取决于事件类型;没有附加数据时省略。