请升级至最新的补丁版本后使用。
基本信息
POST /api/v2/browser-profile/update
接口描述:更新指定浏览器环境的配置信息,包括名称、备注、账号信息、代理配置、指纹参数等。
请求参数
Body 非必需参数可以不传递,传参格式为JSON。
参数名称 | 类型 | 必需 | 默认值 | 示例 | 说明 |
---|---|---|---|---|---|
profile_id | text | 是 | - | h1yynkm | 环境ID,创建环境成功后生成的唯一ID。 |
name | text | 否 | - | user A | 对该环境进行命名,限制100字,方便记忆管理。 |
remark | text | 否 | - | 这是一条说明 | 备注。 |
platform | text | 否 | - | facebook.com | 账号平台的域名,如 facebook.com、amazon.com 等,浏览器启动时默认访问该地址。 |
username | text | 否 | - | myusername | 账号用户名。账号密码或 Cookie 至少填写一个;若账号允许重复,则可都不填写。 |
password | text | 否 | - | 123456 | 账号密码。账号密码或 Cookie 至少填写一个;若账号允许重复,则可都不填写。 |
fakey | text | 否 | - | xxxx xxxx xxxx xxxx xxxx | 2FA 密钥,适用于网站的二次验证码生成,类似 Google 身份验证器。 |
cookie | text | 否 | - | [ { "domain": ".baidu.com", "expirationDate": 1724188800, "name": "BAIDUID", "path": "/", "sameSite": "unspecified", "secure": true, "value": "xxxxxxxxxx", "id": 1 } ] | 账号密码或 Cookie 至少填写一个;若账号允许重复,则可都不填写。支持 JSON 和 Netscape 格式。 |
ignore_cookie_error | text | 否 | 0 | 1 | Cookie 校验失败时的处理方式:0 表示直接返回错误;1 表示过滤掉格式错误的数据,保留正确格式的 Cookie。仅支持 Netscape 格式。 |
tabs | list | 否 | - | ["http://www.baidu.com","https://www.google.com"] | 标签页,浏览器启动时访问的其他 URL 地址;若不填写,则默认只打开 platform 指定的地址。 |
user_proxy_config | object | 否 | - | {"proxy_type":"http","proxy_host":"123.0.0.1", "proxy_port":"12","proxy_user":"12", "proxy_password":"12","proxy_soft":"luminati"} |
环境代理配置,具体结构详见参数对象 userProxyConfig。 ‼️注意:user_proxy_config和proxyid二选一必填。 |
proxyid | text | 否 | - | xxx | 代理 ID,或填写 random 表示随机选择一个代理。‼️注意:user_proxy_config和proxyid二选一必填。 |
ip | text | 否 | - | xxx.xxx.xxx.xxx | 环境使用的代理IP,代理类型为lumauto、oxylabs填写。 |
country | text | 否 | - | us | 环境使用的代理国家/地区,lumauto、oxylabs如果没有IP则需要填写国家。 |
region | text | 否 | - | xx | 环境使用的代理州/省,可不填。 |
city | text | 否 | - | xx | 环境使用的代理城市,可不填。 |
fingerprint_config | object | 是 | - | {"automatic_timezone": "1","language": ["en-US","en"],"flash": "block","fonts": ["all"],"webrtc": "disabled", "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.141 Safari/537.36"} |
指纹配置,具体结构详见参数对象fingerprintConfig。 |
category_id | text | 否 | 0 | 82 | 应用分类 ID,0 表示跟随团队应用。 |
launch_args | list | 否 | - | ["--window-position=400,0","--blink-settings=imagesEnabled=false", "--disable-notifications"] | 启动参数;若通过 API 传递了 launch_args,则以 API 传递的值为准。 |
返回数据
// 执行成功
{
"code": 0,
"data": {
}
"msg": "Success"
}
// 执行失败
{
"code":-1,
"data":{},
"msg":"failed"
}