请升级至最新的补丁版本后使用。
基本信息
POST /api/v2/browser-profile/start
接口描述:用于启动浏览器,需要指定环境ID,启动成功后可以获取浏览器debug接口用于执行selenium和puppeteer自动化。 Selenium需要使用到对应内核版本匹配的Webdriver。需更新到应用版本3.4.1以上,启动浏览器后可在返回值中拿到对应的Webdriver的路径。
请求参数
Body 非必需参数可以不传递,传参格式为JSON。
参数名称 | 类型 | 必需 | 默认值 | 示例 | 说明 |
profile_id | text | 是 | - | h1yynkm | 环境ID,创建环境成功后生成的唯一ID。 |
profile_no | text | 否 | - | 123 | 环境编号,如果已传环境ID则优先使用环境ID。 |
launch_args | list | 否 | - | ["--window-position=400,0","--blink-settings=imagesEnabled=false", "--disable-notifications"] | 启动参数,使用API时,如果API传了“launch_args”,则以API传的值为准。 |
headless | text | 否 | 0 | 0 | 设置是否启动headless浏览器,1:是;0:否(默认)。 |
last_opened_tabs | text | 否 | 1 | 1 | 设置是否继续浏览上次打开的标签页,1:是(默认);0:否。 |
proxy_detection | text | 否 | 1 | 1 | 设置是否打开检测页面,1:是(默认);0:否。 |
password_filling | text | 否 | 0 | 0 | 设置是否启用填充账密功能,1:是;0:否(默认)。仅首次打开环境时生效。 |
password_saving | text | 否 | 0 | 0 | 设置是否允许保存密码,1:是;0:否(默认)。仅Chrome内核生效。 |
cdp_mask | text | 否 | 1 | 1 | 设置是否屏蔽CDP检测,1:是(默认);0:否。iOS 和 Android 端强制开启。 |
delete_cache | text | 否 | 0 | 0 | 设置是否在关闭浏览器后清除缓存,1:是;0:否(默认)。若磁盘空间不足时,建议将该参数设置为1。 |
device_scale | text | 否 | - | 1 | 设置手机模式下的缩放比,值范围0.1-2,填1就是100%。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"
}