启动环境

POST

http://local.zhongyibrowser.com:39025/api/v1/browsers/start

最后修改时间：2026-07-21 07:29:35

启动当前用户、当前团队下的环境。已活跃或正在启动的环境仍会按当前登录态校验环境归属，但不会重复创建进程；url 会在启动后新开标签。headless 显式值优先，未传时沿用环境 command_line；无头模式忽略 window_state。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "env_id": "env_01JABCDEF1234567890",
    "url": "http://example.com",
    "window_state": "normal",
    "headless": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://local.zhongyibrowser.com:39025/api/v1/browsers/start' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "env_id": "env_01JABCDEF1234567890",
    "url": "http://example.com",
    "window_state": "normal",
    "headless": true
}'

返回响应

🟢200

application/json

浏览器启动或复用结果

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "env_id": "env_01JABCDEF1234567890",
        "env_sn": "string",
        "env_name": "string",
        "remark": "string",
        "group": {
            "id": "string",
            "name": "string"
        },
        "status": "active",
        "headless": true,
        "pid": 1,
        "debug_port": 1,
        "ws_endpoint": "string",
        "reused": true
    }
}

🟠400

🟠401

🟠403

🟠404

🟠409

🔴500

🔴502

🔴503

修改于 2026-07-21 07:29:35

获取环境详情

重启环境