云端浏览器 API

连接云端浏览器

CDP WebSocket:不填 session 或 name 时新开;session 连接已有会话;name 有就连接、没有就新开。session 与 name 不可同时提供。新建参数在连接已有会话时忽略。使用 Authorization: Bearer API_KEY,或直接使用创建会话返回的带 signingKey 的 connectUrl。连上后发送 CDP 命令 Praxis.getSession,获取 sessionId、liveViewUrl、consoleUrl。

GET /browser/v1/connect● 支持

请求参数

  • sessionstring可选

    要连接的已有会话 ID,来自创建或列表响应;不能同时提供 name。

  • namestring可选

    按名称连接或创建。

  • signingKeystring可选

    connectUrl 自带凭证;必须同时带 session。

  • contextstring可选

    新会话使用的登录态 ID,来自创建或列表响应;连接已有会话时忽略。

  • persistboolean可选

    关闭时保存登录态。

  • timeoutnumber可选

    新会话最长寿命,单位为秒,可含小数;连接已有会话时忽略。

  • idlenumber可选

    新会话无人连接或观看后的释放等待时长,单位为毫秒;允许 0 或小数,连接已有会话时忽略。

  • labelsstring可选

    JSON 编码的字符串标签对象。

  • viewportstring可选

    JSON 编码的视口,例如 {"width":1280,"height":800}。

返回

101

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

连接与使用指南

响应

此端点没有声明成功响应。