curl -sS -X POST "https://api.adscrawl.net/cdp/live-token" \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"sessionId": "SESSION_ID"}'
// Step 1: 请求实时控制令牌
const token = await fetch("https://api.adscrawl.net/cdp/live-token", {
method: "POST",
headers: {
"content-type": "application/json",
"x-api-key": "YOUR_API_KEY",
},
body: JSON.stringify({ sessionId: "SESSION_ID" }),
}).then((r) => r.json());
// Step 2: 使用返回的 controlUrl 打开实时控制 WebSocket
const socket = new WebSocket(token.controlUrl);
socket.addEventListener("open", () => {
console.log("Live control session connected");
});
socket.addEventListener("close", (event) => {
console.log("Session closed:", event.code, event.reason);
});
{
"ok": true,
"controlUrl": "wss://api.adscrawl.net/cdp/live/SESSION_ID?controlToken=<single-use-token>",
"expiresAt": 1785726630000
}
远程 CDP
签发实时控制令牌
为现有 CDP 会话签发一次性、30 秒有效期的控制令牌，以通过专用 WebSocket 连接进行实时交互式控制。
POST
/
cdp
/
live-token
curl -sS -X POST "https://api.adscrawl.net/cdp/live-token" \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"sessionId": "SESSION_ID"}'
// Step 1: 请求实时控制令牌
const token = await fetch("https://api.adscrawl.net/cdp/live-token", {
method: "POST",
headers: {
"content-type": "application/json",
"x-api-key": "YOUR_API_KEY",
},
body: JSON.stringify({ sessionId: "SESSION_ID" }),
}).then((r) => r.json());
// Step 2: 使用返回的 controlUrl 打开实时控制 WebSocket
const socket = new WebSocket(token.controlUrl);
socket.addEventListener("open", () => {
console.log("Live control session connected");
});
socket.addEventListener("close", (event) => {
console.log("Session closed:", event.code, event.reason);
});
{
"ok": true,
"controlUrl": "wss://api.adscrawl.net/cdp/live/SESSION_ID?controlToken=<single-use-token>",
"expiresAt": 1785726630000
}
当你需要接入并实时交互一个正在运行的 CDP 会话时，请使用此端点获取短时效的控制令牌。将返回的
当实时控制 WebSocket 关闭时，服务器会发送以下原因码之一：
controlUrl 直接传入 WebSocket 构造函数即可开始实时控制。
string
必填
你想要实时控制的活跃 CDP 会话 ID。
响应
boolean
令牌签发成功时为
true。string
一个已将一次性
controlToken 以查询参数形式嵌入的 wss:// WebSocket URL。直接将其传给 new WebSocket(...)，切勿替换或修改令牌。number
controlToken 失效的 Unix 时间戳，单位为毫秒。该令牌有效期为 30 秒，且只能使用一次。| 状态码 | 含义 |
|---|---|
| 200 | 令牌已签发；响应体中包含 controlUrl 和 expiresAt。 |
| 400 | 请求体中缺少 sessionId。 |
| 401 / 403 | API 密钥无效，或没有目标会话的所有权。 |
| 404 / 409 / 410 | 会话不存在、正在停止或已过期。 |
| 503 | 会话后端不可用。 |
| 500 | 签发或存储控制令牌失败。 |
controlToken 在 30 秒 后失效，且只能被消费 一次。如果 WebSocket 连接失败或未在规定时间内打开，请再次调用 POST /cdp/live-token 获取新令牌。打开实时 WebSocket
向目标会话开启实时控制 WebSocket 连接，地址为wss://api.adscrawl.net/cdp/live/{sessionId}?controlToken={token}。服务器会验证 controlToken，连接到会话后端，然后升级你的客户端连接。一旦连接建立，CDP 消息将被双向代理，你将获得完整的交互式控制权。
string
必填
POST /cdp/live-token 返回的 controlUrl 中嵌入的会话 ID。string
必填
来自
POST /cdp/live-token 的一次性令牌。必须在签发后 30 秒内使用，且只能消费一次。| 码 | 原因 | 起因 |
|---|---|---|
| 1000 | cdp_upstream_closed | 上游 CDP 会话正常关闭。 |
| 1000 | idle_timeout | 会话超过了配置的 idleTimeoutMs。 |
| 1000 | max_timeout | 会话超过了配置的 maxSessionMs。 |
| 1011 | cdp_upstream_disconnected | 上游 CDP 连接意外断开。 |
| 1011 | cdp_upstream_error | 上游 CDP 连接发生错误。 |
| 状态码 | 含义 |
|---|---|
| 101 | WebSocket 升级成功；实时控制现已激活。 |
| 401 | controlToken 无效、已过期、已使用过，或与 sessionId 不匹配。 |
| 404 / 409 / 410 | 会话不存在、正在停止或已过期。 |
| 502 | 在 101 升级前无法连接到会话后端。 |
| 503 | 会话后端或控制基础设施不可用。 |
实时控制令牌专为短时手动或有条件交互设计。对于完全自动化的工作流，请直接通过
cdpBaseUrl 使用 Playwright 或 Puppeteer 驱动会话。curl -sS -X POST "https://api.adscrawl.net/cdp/live-token" \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"sessionId": "SESSION_ID"}'
// Step 1: 请求实时控制令牌
const token = await fetch("https://api.adscrawl.net/cdp/live-token", {
method: "POST",
headers: {
"content-type": "application/json",
"x-api-key": "YOUR_API_KEY",
},
body: JSON.stringify({ sessionId: "SESSION_ID" }),
}).then((r) => r.json());
// Step 2: 使用返回的 controlUrl 打开实时控制 WebSocket
const socket = new WebSocket(token.controlUrl);
socket.addEventListener("open", () => {
console.log("Live control session connected");
});
socket.addEventListener("close", (event) => {
console.log("Session closed:", event.code, event.reason);
});
{
"ok": true,
"controlUrl": "wss://api.adscrawl.net/cdp/live/SESSION_ID?controlToken=<single-use-token>",
"expiresAt": 1785726630000
}