编辑环境 - 中屹浏览器本地API

部分编辑当前用户、当前团队下的环境。只更新请求中明确提供的字段；运行中的环境可以保存，新配置在下次启动时生效。浏览器兼容条件变化时由后端重新生成内部 UA 字段，未修改的随机指纹值保持不变。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "name": "string",
    "window": {
        "width": 200,
        "height": 200
    },
    "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": [
        "account_01JABCDEF1234567890"
    ],
    "accounts": [
        {
            "type": "preset",
            "platform_id": "string",
            "name": "string",
            "username": "string",
            "password": "string",
            "twofa_key": "string",
            "remark": "string"
        }
    ],
    "extension_ids": [
        "extension_01JABCDEF1234567890"
    ],
    "common_settings": {
        "block_images": true,
        "block_video_autoplay": true,
        "mute_audio": true,
        "disable_translate_prompt": true,
        "disable_password_save_prompt": true,
        "block_notifications": true,
        "block_clipboard_read": true,
        "stop_open_on_network_error": true,
        "stop_open_on_ip_change": true,
        "stop_open_on_country_change": true
    },
    "fingerprint": {
        "webrtc": {
            "mode": "based_on_ip"
        },
        "timezone": {
            "mode": "real"
        },
        "geolocation": {
            "mode": "real"
        },
        "language": {
            "mode": "real"
        },
        "screen": {
            "mode": "real"
        },
        "fonts": {
            "mode": "real"
        },
        "noise": {
            "canvas": true,
            "webgl": true,
            "audio_context": true,
            "client_rects": true
        },
        "webgl": {
            "mode": "real"
        },
        "memory": {
            "mode": "real"
        },
        "cpu": {
            "mode": "real"
        },
        "do_not_track": {
            "mode": "default"
        },
        "port_scan_protection": {
            "mode": "disabled"
        },
        "hardware_acceleration": {
            "mode": "default"
        },
        "battery": {
            "mode": "real"
        },
        "media_devices": {
            "mode": "real"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'http://local.zhongyibrowser.com:39025/api/v1/browsers/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "window": {
        "width": 200,
        "height": 200
    },
    "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": [
        "account_01JABCDEF1234567890"
    ],
    "accounts": [
        {
            "type": "preset",
            "platform_id": "string",
            "name": "string",
            "username": "string",
            "password": "string",
            "twofa_key": "string",
            "remark": "string"
        }
    ],
    "extension_ids": [
        "extension_01JABCDEF1234567890"
    ],
    "common_settings": {
        "block_images": true,
        "block_video_autoplay": true,
        "mute_audio": true,
        "disable_translate_prompt": true,
        "disable_password_save_prompt": true,
        "block_notifications": true,
        "block_clipboard_read": true,
        "stop_open_on_network_error": true,
        "stop_open_on_ip_change": true,
        "stop_open_on_country_change": true
    },
    "fingerprint": {
        "webrtc": {
            "mode": "based_on_ip"
        },
        "timezone": {
            "mode": "real"
        },
        "geolocation": {
            "mode": "real"
        },
        "language": {
            "mode": "real"
        },
        "screen": {
            "mode": "real"
        },
        "fonts": {
            "mode": "real"
        },
        "noise": {
            "canvas": true,
            "webgl": true,
            "audio_context": true,
            "client_rects": true
        },
        "webgl": {
            "mode": "real"
        },
        "memory": {
            "mode": "real"
        },
        "cpu": {
            "mode": "real"
        },
        "do_not_track": {
            "mode": "default"
        },
        "port_scan_protection": {
            "mode": "disabled"
        },
        "hardware_acceleration": {
            "mode": "default"
        },
        "battery": {
            "mode": "real"
        },
        "media_devices": {
            "mode": "real"
        }
    }
}'

返回响应

🟢200

application/json

更新后的环境标识和运行状态

Bodyapplication/json

示例

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

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

🔴502

🔴503