新建环境

基本信息

接口描述：

创建新的浏览器环境，新建成功后返回浏览器ID

请求参数

Body 参数application/json

name

string

环境名称

必需

环境名称限制1-30字符

示例值:

TigeAI

group_id

number

分组ID

必需

环境分组ID 不填分组ID默认分配到默认分组

system_version

array[string]

系统版本

可选

选择的系统版本详情请查看”附录“里的-系统版本配置详情-

remark

string | null

备注

可选

环境备注信息

示例值:

测试备注

browser

enum<string>

内核类型

可选

默认情况下使用 ’chrome‘

枚举值:

chrome

browser_version

string

内核版本

可选

默认情况下使用 ’autoMatch‘

示例值:

autoMatch

app_class_id

string

应用分类ID

可选

可传入应用分类ID ，0为跟随团队应用

ua_version

array[string]

ua版本范围

可选

>= 1 items

proxy

object

代理配置信息

可选

proxy_mode

number

代理方式

可选

代理方式默认为 “1” 意为自定义代理

proxy_type

enum<string>

代理类型

可选

代理类型取值范围

枚举值:

no_proxysocks5httphttpssky

proxy_custom_json

object

可选

platform

string

账号平台地址

可选

示例值:

https://baidu.com

platform_url

array[string]

标签页地址

可选

打开环境后的标签页地址

platform_account

string

平台账号

可选

导入对应平台地址下的账号值

示例值:

username

platform_password

string

平台密码

可选

导入对应平台地址下的密码值

示例值:

password

array [object {9}]

可选

浏览器缓存数据

domain

string

生效域名范围

可选

expires

number

Cookie过期时间

可选

httpOnly

boolean

安全属性，控制 JavaScript 能否访问 Cookie

可选

name

string

Cookie具体信息的key

可选

path

string

Cookie访问路径范围

可选

sameSite

string

控制跨站请求时是否发送 Cookie

可选

secure

boolean

是否仅通过 HTTPS 协议传输 Cookie

可选

session

boolean

标识是否为会话 Cookie

可选

value

string

Cookie 的核心键值对，用于存储具体数据

可选

start_args

array[string]

启动参数

可选

fingerprint_args

object (环境指纹配置模板)

指纹参数

可选

启动时的指纹选项

user_agent

string

UserAgent

可选

浏览器标识 , 不填将会根据当前版本库数据随机ua。

WebRTC

enum<string>

WebRTC

可选

网站实时通讯技术。

枚举值:

forwardproxylocaldisabled

time_zone

object

时区值

可选

location

object

地理配置参数

可选

language

array[string]

浏览器语言

可选

具体参数说明查看"附录" 中 -语言-详情。

switch_language

enum<string>

是否基于IP匹配

可选

基于IP匹配时将会获取当前代理结果并载入指纹。

枚举值:

默认值:

示例值:

page_language

string

界面语言

可选

‘local’时使用本地语言，具体参数说明查看"附录" 中 -语言-详情。

switch_page_language

enum<string>

基于浏览器语言

可选

基于浏览器语言时获取language第一项语言。

枚举值:

screen_resolution

enum<string>

分辨率

可选

浏览器读取的屏幕分辨率值为：none 分辨率基于User-Agent匹配，自定义时下划线分割宽_高。

枚举值:

none

默认值:

none

示例值:

none1920_1080

fonts

array[string]

字体

可选

字体不传入或空数组默认自动根据系统获取字体，可自定义字体且传入字符串数组。

canvas

enum<string>

canvas指纹

可选

浏览器canvas指纹开关

枚举值:

noisereal

默认值:

noise

示例值:

noise

webgl_image

enum<string>

webgl图像

可选

浏览器webgl图像指纹开关

枚举值:

默认值:

示例值:

webgl

enum<string>

浏览器webgl元数据指纹开关

可选

默认自定义时会自动随机webgl数据，有传入webgl_config时会替换，未传入自动随机。

枚举值:

默认值:

webgl_config

object

浏览器webgl元数据指纹数据

可选

浏览器webgl元数据自定义数据，unmasked_vendor：厂商，unmasked_renderer：渲染，
该数据当webgl值为1时启用，厂商和渲染不能为空，否则使用默认。

audio

enum<string>

音频指纹开关

可选

枚举值:

media_devices

enum<string>

音频设备

可选

枚举值:

012

默认值:

media_device_config

object

音频设备配置

可选

浏览器读取到的电脑音频设备列表

client_rects

enum<string>

ClientRects指纹

可选

枚举值:

speech_switch

enum<string>

SpeechVoices指纹

可选

枚举值:

hardware

enum<string>

电脑CPU核心数

可选

不传默认CPU默认4核

枚举值:

246816

默认值:

示例值:

memory

enum<string>

电脑内存大小

可选

不传默认内存8G

枚举值:

248

默认值:

示例值:

mac

object

设备MAC地址

可选

不传默认随机匹配合适Mac地址

do_not_track

enum<string>

是否禁止网络追踪

可选

枚举值:

defaulttruefalse

默认值:

default

示例值:

default

accelerate

enum<string>

硬件加速

可选

枚举值:

012

默认值:

device_name

object

设备名称

可选

不传默认随机匹配合适设备名称

示例

{
    "name": "TigerAI-1",
    "group_id": "10000",
    "system_version": [
        "Windows 10",
        "Windows 10",
        "Windows 10"
    ],
    "remark": "测试备注",
    "browser": "eu",
    "browser_version": [
        "qui",
        "in occaecat"
    ],
    "proxy": {
        "proxy_mode": "fugiat est officia",
        "proxy_type": "socks5",
        "proxy_custom_json": {
            "searchIp": "auto",
            "host": "192.168.0.1",
            "port": "1000",
            "username": "username123",
            "password": "password123",
            "refresh_url": "tempor ut et cillum"
        }
    },
    "platform": "https://baidu.com",
    "platform_url": null,
    "platform_account": "username",
    "platform_password": "password",
    "cookie": "[   {     \"domain\": \".baidu.com\",     \"expires\": 1773213465,     \"httpOnly\": false,     \"name\": \"BIDUPSID\",     \"path\": \"/\",     \"sameSite\": \"unspecified\",     \"secure\": false,     \"session\": false,     \"value\": \"7BC1A9D4EFA10EE91EF811F1FC37EEB8\"   }]",
    "start_args": "['--disable-gpu']",
    "fingerprint_args": {
        "user_agent": "aliquip nulla cupidatat laborum exercitation",
        "ua_v": "dolor",
        "WebRTC": "disabled",
        "time_zone": {
            "switch": "2",
            "value": "ullamco Duis"
        },
        "location": {
            "type": "ask",
            "switch": "1",
            "latitude": "eiusmod ullamco dolor laborum aute",
            "longitude": "consequat",
            "accuracy": "Lorem"
        },
        "language": [
            "zh-cn",
            "zh-cn",
            "zh-cn"
        ],
        "switch_language": "1",
        "page_language": [
            "en-US"
        ],
        "switch_page_language": "2",
        "screen_resolution": "none",
        "fonts": [
            "enim amet",
            "ullamco adipisicing elit et ut"
        ],
        "canvas": "noise",
        "webgl_image": "0",
        "webgl": "0",
        "webgl_config": {
            "unmasked_vendor": "veniam sed",
            "unmasked_renderer": "fugiat",
            "webgpu": {
                "webgpu_switch": "2"
            }
        },
        "audio": "1",
        "media_device": "0",
        "media_device_config": {
            "audioinput_num": "elit aliquip magna anim",
            "audiooutput_num": "consequat",
            "videoinput_num": "est Ut veniam ea Lorem"
        },
        "client_rects": "0",
        "speech_switch": "0",
        "hardware": "4",
        "device_memory": "8",
        "mac": {
            "type": "0",
            "name": "86-08-81-ff-19-90"
        },
        "do_not_track": "default",
        "accelerate": "2",
        "device_name": {
            "type": "1",
            "name": "laboris"
        }
    }
}

返回响应

🟢200成功

application/json

Body

code

number

状态码

必需

0 为成功 1为失败

msg

string

消息

必需

接口返回的描述信息

data

object

必需

成功时的会返回的字段

eid

string

浏览器ID

必需

创建成功后产生的唯一ID

sort

integer

环境序号

必需

创建成功后产生的环境序号

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "eid": "string",
        "sort": 0
    }
}

基本信息#

请求参数

返回响应

基本信息