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