云端浏览器 API
请求人工接管
为运行中的会话发起人工接管请求,返回接管请求事件。请求尚未过期或完成时,CDP 客户端的 Input.* 指令会被拒绝;再次请求会替换已有的接管说明和到期时刻。
POST
/browser/v1/sessions/{sessionId}/handoff● 支持请求参数
sessionIdstring必填浏览器会话 ID;使用创建或列出会话返回的 id,以 bss_ 开头。
messagestring必填交给人工操作者的接管说明,可为空字符串。
timeoutMsnumber可选接管请求有效时长,单位为毫秒;必须大于 0,可含小数。
返回
200
错误含 statusCode、error、message;自有面另含 code。请求 ID 见 X-Request-Id。 错误
响应
HTTP 200
请求成功。
application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| seq | integer | 当前会话内递增的事件序号,用于事件排序及分页。 |
| id | string | 服务生成的事件唯一标识,使用 UUID 格式。 |
| type | string | 会话账本中的事件类型,用于区分状态变化和会话操作。 |
| processed_at | string | 事件记录时刻,UTC ISO 8601 时间。 |
| session_id | string | 浏览器会话 ID;使用创建或列出会话返回的 id,以 bss_ 开头。 |
| reason | string | 事件发生原因;关闭相关事件记录对应的会话释放原因。 |
| payload | object | 事件附加数据,内容取决于事件类型;没有附加数据时省略。 |