Local API V2 – 指纹接口

获取环境指纹

接口地址

GET /openapi/v2/profiles/{profileId}/fingerprint

用于获取单个环境的指纹配置。

路径参数

名称	类型	必填	说明
profileId	string	是	环境 ID。

覆盖设置环境指纹

接口地址

PUT /openapi/v2/profiles/{profileId}/fingerprint

用于覆盖设置单个环境指纹。

路径参数

名称	类型	必填	说明
profileId	string	是	环境 ID。

请求参数

名称	类型	必填	说明
fingerprint	object	否	指纹配置，见 指纹参数。

刷新单个环境指纹

接口地址

POST /openapi/v2/profiles/{profileId}/fingerprint/refresh

用于刷新单个环境指纹。

路径参数

名称	类型	必填	说明
profileId	string	是	环境 ID。

请求参数

名称	类型	必填	说明
fingerprint	object	否	指纹配置，见 指纹参数。

生成指纹

接口地址

POST /openapi/v2/fingerprints/generate

用于生成一份临时指纹。

请求参数

名称	类型	必填	说明
fingerprint	object	否	指纹配置，见 指纹参数。

请求示例

  -d '{
    "fingerprint": {
      "os": "windows",
      "kernel_version": "142",
      "language": {
        "mode": "ip"
      },
      "timezone": {
        "mode": "ip"
      },
      "webrtc": {
        "mode": "replace",
        "ip_source": "proxy",
        "keep_random_internal_ip": false
      }
    }
  }'

批量刷新环境指纹

接口地址

PATCH /openapi/v2/profiles/fingerprints

用于批量刷新环境指纹。

请求参数

名称	类型	必填	说明
profile_ids	string[]	否	环境 ID 列表。
fingerprint	object	否	指纹配置，见 指纹参数。

获取指纹可选项

接口地址

GET /openapi/v2/fingerprints/options

用于获取系统支持的指纹枚举选项，例如系统类型、内核版本、代理类型、WebRTC 模式等。

参数说明

指纹参数

fingerprint 用于配置环境指纹。所有字段均为可选；不传时按系统规则生成或沿用已有配置。

名称	类型	说明
os	string	系统类型。可选值：random、windows、macos、linux、android、ios。
kernel_version	string	浏览器内核版本。可选值：120、134、142、143、147。
ua	string	User Agent。留空时系统随机生成；填写时需与系统类型和内核版本保持一致。
language	object	浏览器语言配置。
ui_language	object	界面语言配置。
timezone	object	时区配置。
geolocation	object	地理位置配置。
fonts	object	字体配置。
webrtc	object	WebRTC 配置。
screen	object	屏幕配置。
webgl	object	WebGL 配置。
webgpu	object	通用指纹模块配置。
audio_context	object	通用指纹模块配置。
client_rects	object	通用指纹模块配置。
speech_voices	object	通用指纹模块配置。
media_devices	object	通用指纹模块配置。
hardware	object	硬件配置。
privacy	object	隐私配置。
launch	object	启动参数配置。

language

名称	类型	说明
mode	string	浏览器语言模式。可选值：ip、custom。
languages	string[]	浏览器语言列表。mode=custom 时必填，例如 ["en-US", "en"]。

ui_language

名称	类型	说明
mode	string	界面语言模式。可选值：follow_browser_language、current_device_language、custom。
value	string	自定义界面语言。mode=custom 时必填，例如 en-US。

timezone

名称	类型	说明
mode	string	时区来源。可选值：ip、custom、real。
value	string	时区值。仅 mode=custom 时生效。

geolocation

名称	类型	说明
permission	string	地理位置权限。可选值：ask、allow、block。
source	string	坐标来源。可选值：ip、custom。
coordinates.longitude	number	经度。
coordinates.latitude	number	纬度。
coordinates.accuracy	number	精度。

fonts

名称	类型	说明
mode	string	字体模式。可选值：real、random、custom。
values	string[]	字体列表。仅 mode=custom 时生效。

webrtc

名称	类型	说明
mode	string	WebRTC 模式。可选值：real、replace、forward、disabled。
ip_source	string	替换模式来源。仅 mode=replace 时生效。可选值：manual、proxy、random。
ip	string	手动指定内网 IP。仅 ip_source=manual 时生效。
keep_random_internal_ip	boolean	随机内网 IP 是否保持不变。仅 ip_source=random 时生效。

screen

名称	类型	说明
resolution_mode	string	分辨率模式。可选值：recommended、random、custom、real。
resolution.width	integer	分辨率宽度。
resolution.height	integer	分辨率高度。
window_size_mode	string	窗口大小模式。可选值：recommended、custom。
window_size.width	integer	窗口宽度。
window_size.height	integer	窗口高度。

webgl

名称	类型	说明
image_mode	string	WebGL 图像模式。可选值：real、mask。
metadata_mode	string	WebGL 元数据模式。可选值：real、random、custom。
manufacturer	string	WebGL 厂商。仅 metadata_mode=custom 时生效。
renderer	string	WebGL 渲染器。仅 metadata_mode=custom 时生效。

webgpu

名称	类型	说明
mode	string	WebGPU 模式。可选值：real、mask、disabled。

噪声指纹模块

audio_context、client_rects、speech_voices、media_devices 使用同一结构：

名称	类型	说明
mode	string	模块模式。可选值：real、mask。

hardware

名称	类型	说明
cpu_cores.mode	string	CPU 核心数取值模式。可选值：random、custom、real。
cpu_cores.value	string	自定义 CPU 核心数。仅 mode=custom 时生效。
memory_gb.mode	string	内存取值模式。可选值：random、custom、real。
memory_gb.value	string	自定义内存 GB。仅 mode=custom 时生效。
device_name_mode	string	设备名模式。可选值：real、random、custom。
device_name	string	设备名。仅 device_name_mode=custom 时生效。
mac_address_mode	string	MAC 地址模式。可选值：real、random、custom。
mac_address	string	MAC 地址。仅 mac_address_mode=custom 时生效。

privacy

名称	类型	说明
do_not_track_mode	string	Do Not Track。可选值：default、enabled、disabled。
battery_mode	string	电池模式。可选值：real、mask、disabled。
port_scan_protection_enabled	boolean	是否开启端口扫描保护。
hardware_acceleration_mode	string	硬件加速。可选值：default、enabled、disabled。

launch

名称	类型	说明
start_params	string	浏览器启动参数，多个参数用英文逗号分隔。

指纹可选项响应字段

GET /openapi/v2/fingerprints/options 的 data 可能包含：

名称	类型	说明
os_options	string[]	系统类型选项。
kernel_version_options	string[]	浏览器内核版本选项。
proxy_type_options	string[]	代理类型选项。
ip_check_provider_options	string[]	IP 检测渠道选项。
restore_session_options	string[]	恢复会话选项。
fingerprint_language_mode_options	string[]	浏览器语言模式选项。
fingerprint_ui_language_mode_options	string[]	界面语言模式选项。
timezone_mode_options	string[]	时区模式选项。
geolocation_permission_options	string[]	地理位置权限选项。
geolocation_source_options	string[]	地理位置来源选项。
font_mode_options	string[]	字体模式选项。
webgl_image_mode_options	string[]	WebGL 图像模式选项。
webgl_metadata_mode_options	string[]	WebGL 元数据模式选项。
webgpu_mode_options	string[]	WebGPU 模式选项。
audio_context_mode_options	string[]	AudioContext 模式选项。
client_rects_mode_options	string[]	ClientRects 模式选项。
speech_voices_mode_options	string[]	SpeechVoices 模式选项。
media_devices_mode_options	string[]	MediaDevices 模式选项。
cpu_cores_mode_options	string[]	CPU 核心数模式选项。
memory_mode_options	string[]	内存大小模式选项。
device_name_mode_options	string[]	设备名模式选项。
mac_address_mode_options	string[]	MAC 地址模式选项。
battery_mode_options	string[]	电池模式选项。
do_not_track_mode_options	string[]	Do Not Track 模式选项。
hardware_acceleration_mode_options	string[]	硬件加速模式选项。
web_rtc_mode_options	string[]	WebRTC 模式选项。
web_rtc_ip_source_options	string[]	WebRTC IP 来源选项。
resolution_mode_options	string[]	屏幕分辨率模式选项。
window_size_mode_options	string[]	窗口尺寸模式选项。