菜单

启动浏览器

基本信息

GET  /api/v1/browser/start

接口描述：用于启动浏览器，需要指定环境ID，启动成功后可以获取浏览器debug接口用于执行selenium和puppeteer自动化。 Selenium需要使用到对应内核版本匹配的Webdriver。需更新到应用版本3.4.1以上，启动浏览器后可在返回值中拿到对应的Webdriver的路径。

请求参数

Query 非必需参数可以不传递。

参数名称	必需	默认值	示例	说明	备注
user_id	是	-	h1yynkm	通过环境ID启动，创建环境成功后生成的唯一ID。
serial_number	否	-	123	通过环境编号启动，如果已传递环境ID则优先用环境ID。
open_tabs	否	0	1	是否打开平台和历史页面，0:打开(默认)，1:不打开。	需升级到V2.4.2.9及以上版本。
ip_tab	否	1	0	是否打开ip检测页，0:不打开，1:打开(默认)。	需升级到V2.5.7.9及以上版本。
new_first_tab	否	0	1	是否使用新版ip检测页： 1: 新版，0：旧版（默认）。	需升级到 V2.6.6.9及以上版本。
launch_args	否	-	["--window-position=400,0","--blink-settings=imagesEnabled=false", "--disable-notifications"]	启动参数，例：--blink-settings=imagesEnabled=false: 禁止图片加载 --disable-notifications: 禁用通知。使用API时，如果API传了“launch_args”，则以API传的值为准。	需升级到V2.4.6.7及以上版本。
headless	否	0	1	是否启动headless浏览器 0:否（默认）1:是。	需升级到V2.4.6.7及以上版本。
disable_password_filling	否	0	1	是否禁用填充账密功能 0:否（默认）1:是。	需升级到V2.4.6.7及以上版本。
clear_cache_after_closing	否	0	1	关闭浏览器后是否清除缓存 0:否（默认）1:是。	需升级到V2.4.7.6及以上版本。若磁盘空间不足时，建议将该参数设置为1。
enable_password_saving	否	0	1	是否允许保存密码 0:否（默认）1:是。	需升级到V2.4.8.7及以上版本。
cdp_mask	否	1	1	是否屏蔽 CDP 检测 1：是（默认），0：否	需升级到V2.7.0.2及以上版本。iOS 和 Android 端强制开启
device_scale	否	-	1	手机模式有效，传参范 0.1至 2，填1就是100%	需升级到 v2.7.3.8及以上版本。chrome 128 内核以上且是 Android 和 iOS 才生效。

返回数据


//执行成功
{
  "code":0,
  "data":{
    "ws":{
      "selenium":"127.0.0.1:xxxx",    //浏览器debug接口，可用于selenium自动化
      "puppeteer":"ws://127.0.0.1:xxxx/devtools/browser/xxxxxx"   //浏览器debug接口，可用于puppeteer自动化
    },
    "debug_port": "xxxx", // debug端口
    "webdriver": "C:\\xxxx\\chromedriver.exe" // webdriver路径
  },
  "msg":"success"
}

//执行失败
{
  "code":-1,
  "data":{},
  "msg":"failed"
}

上一个

浏览器

下一个

启动浏览器V2

最近修改: 2025-02-18Powered by

大纲