跳转到内容
API 参考
/
浏览器
/
/Cloud Runtime

启动云端运行环境

Request

把浏览器环境作为云运行时启动。

  • 前置条件：环境必须存在于你的团队，且不能是端到端加密或正在移交。必须绑定代理，且在受理启动前会检查其可达性。浏览器内核必须是云浏览器支持的，这排除了 Firefox。会校验团队的打开数量上限；在启用云浏览器计费的部署上还会检查 AI 额度余额。
  • 每个环境一个运行：一名成员对同一环境只能持有一个活跃运行。团队启用安全锁时，其他成员的运行会阻塞你的启动。
  • 完成信号：已受理，未完成。 data 为空；运行时是异步开通的。轮询 /cloudbrowser/page 直到 cloudBrowserStatus 为 RUNNING，再调用 /cloudbrowser/connect 获取 cdpUrl。启动可能已被受理但随后失败，这会在该页面上体现。
  • 并发：同一环境的并发启动由锁串行化；竞争失败的一方被拒绝，而不是排队。
  • 重试：超时后请读取 /cloudbrowser/page——不要重发。

已记录的业务错误码：19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037。 各错误码的含义见 Error Codes。任何接口还可能返回通用错误码。

Bodyapplication/jsonrequired
envIdstring(EnvironmentId)^[1-9]\d*$required

Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript precision loss on 64-bit integers.

Example:"1800000000000001"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudbrowser/start \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001"
  }'

Responses

Success

Bodyapplication/json
codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0
msgstring or nullrequired

Error message. Usually null on success.

Example:null
requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
datanull
Example:null
Response
{
  "code": 0,
  "msg": null,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e",
  "data": null
}