高级创建浏览器

API 参考

高级创建浏览器

Request

创建一个浏览器，并指定完整的指纹配置。

前置条件：与快速创建相同的套餐额度与当日配额校验。浏览器名称在团队内必须唯一，坐标必须落在中国大陆以外，且 advancedSetting.ua 必须与 uaVersion 一致。传入的 proxyId 必须已存在于团队中。
副作用：写入浏览器、其账号凭据（加密存储）和启动后配置；消耗套餐额度与当日创建计数。自定义平台 URL 还会新增一条站点记录。
完成信号：同步。data 是新建浏览器的 ID。
重试：不幂等。显式传了相同 envName 的第二次调用会因唯一性校验失败；不传名称则会重复创建。没有幂等键。超时后不要盲目重试，先查询状态。
Local API：内核候选集会按运行中的桌面客户端版本过滤，且同一团队的并发调用会被团队级锁串行化。

已记录的业务错误码：19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175。各错误码的含义见 Error Codes。任何接口还可能返回通用错误码。

Bodyapplication/json

browserTypeIdintegerrequired

浏览器类型 ID；1=Chrome，2=Firefox

operatorSystemIdintegerrequired

操作系统类型 ID；1:Windows 2:macOS 3:Android 4:IOS 5:Linux

isEncryptinteger

是否加密该浏览器；0=否，1=是

startupParamsArray of strings

额外的浏览器启动参数

accountInfoobject(AccountInfo)

账号信息

advancedSettingobject(AdvancedSetting)

浏览器指纹高级设置

afterStartupConfigobject(AfterStartupConfig)

启动后的配置项

browserCoreinteger

内核版本；默认 0（自动匹配）。可用版本通过 /api/env/advanced/ua/versions 查询。

cookiesstring

预加载的 Cookie 字符串（可选）

envNamestring

环境名称

envRemarkstring

环境备注；最大长度：1500 字符

groupIdstring

环境分组 ID；默认：未分组（0）

groupNamestring, <= 50 characters

分组名称（最多50个字符）。如果提供了该参数，系统会先检查 groupId：如果找到有效分组则使用该分组；否则按 groupName 查找。如果存在同名分组则引用该分组；如果不存在则新建分组。每个团队最多限制1000个分组。

proxyIdstring

代理 ID；默认：0

tagIdsArray of strings

标签 ID；默认：无

uaVersioninteger

UA 预设版本；默认 0（全部）

disableAudiointeger

禁用音频：0 = 关，1 = 开

disableImginteger

禁用图片加载：0 = 关，1 = 开

disableVideointeger

禁用视频加载：0 = 关，1 = 开

imgLimitSizeinteger

图片最大尺寸（KB）

proxyobject

代理信息

curl -i -X POST \
  http://127.0.0.1:40000/api/env/create/advanced \
  -H 'Content-Type: application/json' \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "isEncrypt": 1
  }'

Responses

成功。data 是单个字符串值。

Headers

any

Bodyapplication/json

codeintegerrequired

msgstring or nullrequired

datastringrequired

requestIdstringrequired

Response

{
  "code": 0,
  "msg": null,
  "data": "string",
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}