启动浏览器（支持批量）

POST

/open/browser/launch

使用团队 apiKey 与业务环境 ID 列表 envIds 校验权限并启动；成功项返回 webSocketDebuggerUrl，可供 Puppeteer / Playwright 通过 CDP 连接。
若本机缺少可用浏览器内核，启动项会快速失败并提示用户前往 Flux Browser 客户端的“设置 > 版本更新”安装内核。
启动前会预占团队与 NST 启动次数，并按每个环境的实际启动结果自动确认或释放预占次数。
已在运行或启动中的环境会拒绝重复启动并释放本次预占次数。

请求参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

HTTP 200，业务结果见 succeed 与 code

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

cURL

单条启动批量启动

curl --location 'http://prod-cn.your-api-server.com/open/browser/launch' \
--header 'Content-Type: application/json' \
--data '{
    "apiKey": "550e8400-e29b-41d4-a716-446655440000",
    "envIds": [
        "environment-uuid-1"
    ]
}'

响应示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "results": [
            {
                "envId": "string",
                "profileId": "string",
                "success": true,
                "port": 9222,
                "proxy": "string",
                "webSocketDebuggerUrl": "string",
                "error": "string"
            }
        ]
    },
    "succeed": true,
    "timestamp": 0
}

修改于 2026-07-31 07:37:24

更新环境（支持批量）

停止浏览器（支持批量）