创建环境 - 中屹浏览器本地API

创建当前用户、当前团队下的单个未启动环境。请求只包含公开配置意图；Local API 注入真实桌面平台并在本机解析 API 代理，后端负责生成 UA Client Hints、噪声、电池和媒体设备等内部指纹值。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "name": "string",
    "window": {
        "width": 800,
        "height": 600
    },
    "browser": {
        "kernel_version": "string",
        "system_os": "Windows",
        "system_version": "string",
        "ua_version": "string",
        "user_agent": "string"
    },
    "group_id": "string",
    "cookies": [
        {
            "name": "string",
            "value": "string",
            "property1": null,
            "property2": null
        }
    ],
    "remark": "string",
    "command_line": "string",
    "proxy": {
        "mode": "none"
    },
    "account_ids": [],
    "accounts": [],
    "extension_ids": [],
    "common_settings": {
        "block_images": false,
        "block_video_autoplay": false,
        "mute_audio": false,
        "disable_translate_prompt": false,
        "disable_password_save_prompt": false,
        "block_notifications": false,
        "block_clipboard_read": false,
        "stop_open_on_network_error": false,
        "stop_open_on_ip_change": false,
        "stop_open_on_country_change": false
    },
    "fingerprint": {
        "webrtc": {
            "mode": "based_on_ip"
        },
        "timezone": {
            "mode": "based_on_ip"
        },
        "geolocation": {
            "mode": "based_on_ip"
        },
        "language": {
            "mode": "based_on_ip"
        },
        "screen": {
            "mode": "random"
        },
        "fonts": {
            "mode": "random"
        },
        "noise": {
            "canvas": true,
            "webgl": true,
            "audio_context": true,
            "client_rects": true
        },
        "memory": {
            "mode": "random"
        },
        "cpu": {
            "mode": "random"
        },
        "do_not_track": {
            "mode": "default"
        },
        "port_scan_protection": {
            "mode": "enabled"
        },
        "hardware_acceleration": {
            "mode": "default"
        },
        "battery": {
            "mode": "random"
        },
        "media_devices": {
            "mode": "random"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://local.zhongyibrowser.com:39025/api/v1/browsers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "window": {
        "width": 800,
        "height": 600
    },
    "browser": {
        "kernel_version": "string",
        "system_os": "Windows",
        "system_version": "string",
        "ua_version": "string",
        "user_agent": "string"
    },
    "group_id": "string",
    "cookies": [
        {
            "name": "string",
            "value": "string",
            "property1": null,
            "property2": null
        }
    ],
    "remark": "string",
    "command_line": "string",
    "proxy": {
        "mode": "none"
    },
    "account_ids": [],
    "accounts": [],
    "extension_ids": [],
    "common_settings": {
        "block_images": false,
        "block_video_autoplay": false,
        "mute_audio": false,
        "disable_translate_prompt": false,
        "disable_password_save_prompt": false,
        "block_notifications": false,
        "block_clipboard_read": false,
        "stop_open_on_network_error": false,
        "stop_open_on_ip_change": false,
        "stop_open_on_country_change": false
    },
    "fingerprint": {
        "webrtc": {
            "mode": "based_on_ip"
        },
        "timezone": {
            "mode": "based_on_ip"
        },
        "geolocation": {
            "mode": "based_on_ip"
        },
        "language": {
            "mode": "based_on_ip"
        },
        "screen": {
            "mode": "random"
        },
        "fonts": {
            "mode": "random"
        },
        "noise": {
            "canvas": true,
            "webgl": true,
            "audio_context": true,
            "client_rects": true
        },
        "memory": {
            "mode": "random"
        },
        "cpu": {
            "mode": "random"
        },
        "do_not_track": {
            "mode": "default"
        },
        "port_scan_protection": {
            "mode": "enabled"
        },
        "hardware_acceleration": {
            "mode": "default"
        },
        "battery": {
            "mode": "random"
        },
        "media_devices": {
            "mode": "random"
        }
    }
}'

返回响应

🟢201

application/json

创建后的环境标识

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "env_id": "env_01JABCDEF1234567890",
        "name": "string",
        "status": "inactive"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

🔴502

🔴503