菜单

更新环境V2

请升级至最新的补丁版本后使用。

基本信息
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.comamazon.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"
}


上一个
更新环境信息
下一个
查询环境
最近修改: 2025-08-20Powered by