云端浏览器 API

读取调试地址

读取当前会话及各标签页的实时观看地址和 CDP 连接地址。直接使用返回的完整链接,保留查询凭证;会话不在运行状态时 pages 为空,返回地址不代表会话仍可连接。

GET /browser/v1/sessions/{sessionId}/debug● 支持

请求参数

  • sessionIdstring必填

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

返回

200

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

连接与使用指南

响应

HTTP 200

请求成功。

application/json

名称类型说明
debuggerFullscreenUrlstring会话实时画面的完整跳转地址,携带观看凭证;与 debuggerUrl 相同。
debuggerUrlstring会话实时画面的完整跳转地址;直接打开,勿移除查询凭证。
wsUrlstring连接当前会话的 CDP WebSocket 地址,自带 signingKey,无需额外 API Key。
pagesarray<object>当前浏览器标签页及各页的实时观看地址;会话不在运行状态时为空数组。
pages[].idstring浏览器标签页的目标 ID,可用于实时画面地址中的 pageId。
pages[].urlstring该浏览器标签页当前报告的页面地址。
pages[].titlestring该浏览器标签页当前报告的页面标题。
pages[].faviconUrlstring兼容的页面图标地址字段,当前固定返回空字符串。
pages[].debuggerUrlstring此标签页实时画面的完整跳转地址,包含观看凭证。
pages[].debuggerFullscreenUrlstring此标签页实时画面的完整跳转地址,与该页 debuggerUrl 相同。