1. 环境基础
VirtualBrowser
  • 接入前必读
  • 附录 A:MCP 接口(AI 自动化)
  • 附录 B:常见问题
  • 环境基础
    • 获取浏览器环境列表
      GET
    • 获取浏览器环境列表
      POST
    • 获取环境完整参数
      GET
    • 获取运行中的环境列表
      GET
    • 创建环境
      POST
    • 更新环境
      POST
    • 删除环境
      POST
    • 启动环境
      POST
    • 关闭环境
      POST
  • 环境数据
    • 删除环境数据
      POST
    • 获取环境cookie
      GET
    • 更新环境cookie
      POST
    • 清除环境缓存
      POST
    • 更新环境指纹
      POST
  • 运行与工具
    • 查询当前环境ID是否在运行中
      GET
    • 窗口排列
      POST
    • 获取内核版本信息
      GET
  • 分组管理
    • 获取分组列表
      GET
    • 添加分组
      POST
    • 更新分组名称
      POST
    • 删除分组
      POST
  • 插件管理
    • 获取插件列表
      GET
    • 添加插件
      POST
    • 删除插件
      POST
  • 平台账号
    • 获取环境中平台保存的账号密码
    • 新增环境中平台账号密码
    • 更新环境中平台账号密码
    • 删除环境中平台账号密码
  • 云同步
    • 查询环境云同步状态
    • 设置环境云同步开关
    • 删除云端备份
  1. 环境基础

创建环境

POST
/api/addBrowser
创建环境,支持配置名称、备注、分组、代理和全部指纹参数。未传的字段自动随机生成。

请求参数

Header 参数

Body 参数application/json

示例
{
    "name": "环境1",
    "group": [
        "默认分组"
    ],
    "remark": "string",
    "os": "string",
    "chrome_version": 0,
    "core_version": "string",
    "proxy": {
        "mode": 0,
        "value": "string",
        "protocol": "string",
        "host": "string",
        "port": 0,
        "user": "string",
        "pass": "string",
        "API": "string"
    },
    "cookie": {
        "mode": 0,
        "value": "string",
        "jsonStr": "string"
    },
    "homepage": {
        "mode": 0,
        "value": "string"
    },
    "ua": {
        "mode": 0,
        "value": "string"
    },
    "ua-full-version": {
        "mode": 0,
        "value": "string"
    },
    "sec-ch-ua": {
        "mode": 0,
        "value": []
    },
    "ua-language": {
        "mode": 0,
        "language": "string",
        "value": "string"
    },
    "time-zone": {
        "mode": 0,
        "zone": "string",
        "utc": "string",
        "locale": "string",
        "name": "string",
        "value": 0
    },
    "webrtc": {
        "mode": 0
    },
    "location": {
        "mode": 0,
        "enable": 0,
        "longitude": "string",
        "latitude": "string",
        "precision": 0
    },
    "screen": {
        "mode": 0,
        "width": 0,
        "height": 0,
        "_value": "string"
    },
    "fonts": {
        "mode": 0,
        "value": []
    },
    "canvas": {
        "mode": 0,
        "r": 0,
        "g": 0,
        "b": 0,
        "a": 0
    },
    "webgl-img": {
        "mode": 0,
        "r": 0,
        "g": 0,
        "b": 0,
        "a": 0
    },
    "webgl": {
        "mode": 0,
        "vendor": "string",
        "render": "string"
    },
    "webgpu": {
        "mode": 0,
        "vendor": "string",
        "architecture": "string",
        "device": "string",
        "description": "string"
    },
    "audio-context": {
        "mode": 0,
        "channel": 0,
        "analyer": 0
    },
    "media": {
        "mode": 0
    },
    "client-rects": {
        "mode": 0,
        "width": 0,
        "height": 0
    },
    "speech_voices": {
        "mode": 0,
        "value": []
    },
    "ssl": {
        "mode": 0,
        "value": []
    },
    "cpu": {
        "mode": 0,
        "value": 0
    },
    "memory": {
        "mode": 0,
        "value": 0
    },
    "device-name": {
        "mode": 0,
        "value": "string"
    },
    "mac": {
        "mode": 0,
        "value": "string"
    },
    "dnt": {
        "mode": 0,
        "value": 0
    },
    "port-scan": {
        "mode": 0,
        "value": []
    },
    "gpu": {
        "mode": 0,
        "value": 0
    },
    "launchArgs": {
        "mode": 0,
        "value": "string"
    },
    "enableCloudSync": true,
    "cloudId": "string",
    "accountList": [
        {
            "origin_url": "string",
            "username_value": "string",
            "password_value": "string",
            "display_name": "string",
            "action_url": "string",
            "date_created": 0
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/addBrowser' \
--header 'api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data '{
    "name": "环境1",
    "group": [
        "默认分组"
    ],
    "remark": "string",
    "os": "string",
    "chrome_version": 0,
    "core_version": "string",
    "proxy": {
        "mode": 0,
        "value": "string",
        "protocol": "string",
        "host": "string",
        "port": 0,
        "user": "string",
        "pass": "string",
        "API": "string"
    },
    "cookie": {
        "mode": 0,
        "value": "string",
        "jsonStr": "string"
    },
    "homepage": {
        "mode": 0,
        "value": "string"
    },
    "ua": {
        "mode": 0,
        "value": "string"
    },
    "ua-full-version": {
        "mode": 0,
        "value": "string"
    },
    "sec-ch-ua": {
        "mode": 0,
        "value": []
    },
    "ua-language": {
        "mode": 0,
        "language": "string",
        "value": "string"
    },
    "time-zone": {
        "mode": 0,
        "zone": "string",
        "utc": "string",
        "locale": "string",
        "name": "string",
        "value": 0
    },
    "webrtc": {
        "mode": 0
    },
    "location": {
        "mode": 0,
        "enable": 0,
        "longitude": "string",
        "latitude": "string",
        "precision": 0
    },
    "screen": {
        "mode": 0,
        "width": 0,
        "height": 0,
        "_value": "string"
    },
    "fonts": {
        "mode": 0,
        "value": []
    },
    "canvas": {
        "mode": 0,
        "r": 0,
        "g": 0,
        "b": 0,
        "a": 0
    },
    "webgl-img": {
        "mode": 0,
        "r": 0,
        "g": 0,
        "b": 0,
        "a": 0
    },
    "webgl": {
        "mode": 0,
        "vendor": "string",
        "render": "string"
    },
    "webgpu": {
        "mode": 0,
        "vendor": "string",
        "architecture": "string",
        "device": "string",
        "description": "string"
    },
    "audio-context": {
        "mode": 0,
        "channel": 0,
        "analyer": 0
    },
    "media": {
        "mode": 0
    },
    "client-rects": {
        "mode": 0,
        "width": 0,
        "height": 0
    },
    "speech_voices": {
        "mode": 0,
        "value": []
    },
    "ssl": {
        "mode": 0,
        "value": []
    },
    "cpu": {
        "mode": 0,
        "value": 0
    },
    "memory": {
        "mode": 0,
        "value": 0
    },
    "device-name": {
        "mode": 0,
        "value": "string"
    },
    "mac": {
        "mode": 0,
        "value": "string"
    },
    "dnt": {
        "mode": 0,
        "value": 0
    },
    "port-scan": {
        "mode": 0,
        "value": []
    },
    "gpu": {
        "mode": 0,
        "value": 0
    },
    "launchArgs": {
        "mode": 0,
        "value": "string"
    },
    "enableCloudSync": true,
    "cloudId": "string",
    "accountList": [
        {
            "origin_url": "string",
            "username_value": "string",
            "password_value": "string",
            "display_name": "string",
            "action_url": "string",
            "date_created": 0
        }
    ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "success": true,
    "data": {
        "id": 85
    }
}
修改于 2026-11-09 06:37:55
上一页
获取运行中的环境列表
下一页
更新环境
Built with