API 概述

Virtual Browser 提供完整的 HTTP API 接口，允许用户控制虚拟浏览器环境。借助 Puppeteer 或 Playwright，用户可以启动浏览器、访问网页、获取页面内容，并在完成后关闭浏览器。能够实现自动化测试、网页抓取或在隔离环境中进行网页交互场景的全自动操作。

接口采用 RESTful 风格设计，默认端口号：9000

请求 URL

http://localhost:9000

请求类型

Content-Type: application/json

请求认证

TIP

2.1.5 以上版本，增加 api-key 请求头认证

api-key: DZdGdlOykzTgfggUMKVHSXbXe4LVTZN2

主要功能

浏览器环境管理

• 创建、更新、删除浏览器环境
• 启动和关闭浏览器实例
• 获取浏览器列表和详细信息
• 管理浏览器数据

Cookie 管理

• 获取和更新浏览器 Cookie
• 支持 JSON 格式的 Cookie 配置

指纹管理

• 更新浏览器指纹配置
• 支持 User Agent、时区、地理位置等设置

分组管理

• 创建、更新、删除浏览器分组
• 按分组组织浏览器环境

插件管理

• 安装、删除浏览器插件
• 管理插件列表

示例

GET /api/getBrowserList HTTP/1.1
Host: localhost:9000
api-key: DZdGdlOykzTgfggUMKVHSXbXe4LVTZN2