新建浏览器V2-Local API 接口文档

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

基本信息

POST /api/v2/browser-profile/create

接口描述：新建浏览器，支持配置平台账密和Cookie、代理ID和代理信息、指纹信息等等，新建成功后返回浏览器的环境ID。

请求参数

Body 非必需参数可以不传递，传参格式为JSON。

参数名称	类型	必需	默认值	示例	说明
name	text	否	-	user A	对该环境进行命名，限制100字，方便记忆管理。
group_id	text	是		100	添加到对应分组的ID，未分配分组则可以传0。
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 格式。
repeat_config	list	否	-	[2,3]	账号去重，默认允许重复;0允许重复;2根据账密去重;3根据cookie去重;4根据c_user去重(c_user是FaceBook专有标记);
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	环境使用的代理城市，可不填。
ipchecker	text	否	-	ip2location	IP查询渠道，支持传入ip2location、ipapi。
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 表示跟随团队应用。

返回数据

// 执行成功
{
    "data": {
        "profile_id": "xxxx", // 环境ID
        "profile_no": "xxxx" // 环境编号
    },
    "code": 0,
    "msg": "Success"
}
        
// 执行失败
{
  "code":-1,
  "data":{},
  "msg":"failed"
}