API 文档

Virtual Browser 提供完整的 HTTP API 接口，支持浏览器环境的创建、管理和控制。

专业版功能

REST API 需**专业版（会员）**并在客户端登录后使用。请在客户端 API 菜单查看实际 http://localhost:{port} 与 api-key（端口非固定 9000）。

认证

所有 API 请求都需要在请求头中包含 api-key：

api-key: DZdGdlOykzTgfggUMKVHSXbXe4LVTZN2

参考文档

• Apifox 项目：https://2uzg2znjfy.apifox.cn/
• 金山文档：https://www.kdocs.cn/l/cq4lGX94cYk1

本文档与上述在线文档保持一致，若存在差异以在线文档为准。

API 端点列表

浏览器环境管理

• 获取浏览器环境列表 - GET|POST /api/getBrowserList
• 获取环境完整参数 - GET /api/getBrowserFullParameters
• 获取运行中的环境列表 - GET /api/getBrowserRunningList
• 创建环境 - POST /api/addBrowser
• 更新环境 - POST /api/updateBrowser
• 删除环境 - POST /api/deleteBrowser
• 启动环境 - POST /api/launchBrowser
• 关闭环境 - POST /api/stopBrowser
• 删除环境数据 - POST /api/deleteBrowserData
• 清理环境缓存 - POST /api/clearCache
• 查询环境是否运行 - GET /api/isBrowserRunning

Cookie 管理

• 获取环境 cookie - GET /api/getCookie
• 更新环境 cookie - POST /api/updateCookie

指纹管理

• 更新环境指纹 - POST /api/randomizeFingerprint

分组管理

• 获取分组列表 - GET /api/getGroupList
• 添加分组 - POST /api/addGroup
• 更新分组名称 - POST /api/updateGroup
• 删除分组 - POST /api/deleteGroup

插件管理

• 获取插件列表 - GET /api/getCrxList
• 添加插件 - POST /api/addCrx
• 删除插件 - POST /api/deleteCrx

平台账号管理

• 获取平台账号列表 - GET /api/getAccountList
• 添加平台账号 - POST /api/addAccount
• 删除平台账号 - POST /api/deleteAccount
• 更新平台账号列表 - POST /api/updateAccountList

MCP

• MCP 端点 - POST/GET/DELETE /mcp

响应格式

所有 API 响应都遵循统一的格式：

成功响应

{
  "success": true,
  "data": {
    // 响应数据
  }
}

错误响应

{
  "success": false,
  "error": "错误信息"
}

状态码

• 200 - 请求成功
• 400 - 请求参数错误
• 401 - 认证失败
• 404 - 资源不存在
• 500 - 服务器内部错误