一个身份,相互关联的信号示例数据
固定 ID
customer-123设备系列Windows · Chromium · 1920 × 1080
区域设置 + 时区
en-US / America/New_York输出分组User agent、屏幕、navigator、图形等
生成配置,再应用支持的字段
从一次指纹请求开始。使用你的自动化框架所支持的响应字段;下载 JSON 并不会自动应用所有浏览器信号。
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/fingerprint/generate",
params={
"key": os.environ["CAPZY_API_KEY"],
"format": "chromium",
"tags": "Windows",
"country": "us",
"id": "customer-123", # reuse with the same options
}, timeout=30,
)
response.raise_for_status()
fp = response.json()
if fp.get("errorId"):
raise RuntimeError(fp)
print(fp["userAgent"]["userAgent"])激活 API 并复制你的密钥
选择一个有效的 Fingerprint API 套餐,并使用你账户中的 Capzy API 密钥。将其保存为 CAPZY_API_KEY。
打开 Fingerprint API选择身份约束条件
发送 format=chromium、一个操作系统标签和一个国家代码。使用相同的选项复用 id、uuid 或 seed,即可重新生成同一身份。
将支持的字段应用到你的浏览器
Playwright 示例应用了 user agent、locale、timezone 和 viewport。Canvas、WebGL 等其他信号需要特定浏览器的支持;请参阅完整指南。
选择需要的指纹配置
key 为必填项。身份和筛选选项为可选项;重新生成配置时请保持一致。
key必填 · API 密钥- 你的 Capzy API 密钥。请将其保存在服务器端,切勿放在浏览器 JavaScript、公开仓库或会被记录的请求 URL 中。
id / uuid / seed可选 · 身份- 可互相替代的身份选择器。提供一个固定值,并复用相同的筛选配置,即可确定性地生成。省略则生成新身份。
format默认 · chromium- 选择 chromium 获取这些示例所使用的面向浏览器的 JSON 结构,或选择 raw 获取原始配置表示。
tags可选 · 操作系统- 筛选设备系列,例如 Windows、macOS 或 Linux。请让请求的操作系统与你使用的浏览器保持一致。
country可选 · 两位代码- 设置区域设置和地区配置提示。指纹的国家/地区不是代理;当 IP 位置很重要时,请另行配置浏览器出口。
min_browser_version / browser_version可选 · 版本约束- 参考完整 API 文档筛选版本。build_version 和 force_browser_version 提供更多控制项;请使用你的浏览器集成所支持的值。
按字段组阅读指纹
一个简化的示意响应。你的 API 响应包含完整的指纹,可能因设备和格式而有所不同。
Playwright 示例应用了 user agent、locale、timezone 和 viewport。Canvas、WebGL 等其他信号需要特定浏览器的支持;请参阅完整指南。
{
"id": "customer-123",
"country": "us",
"userAgent": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...",
"platform": "Win32"
},
"screen": {
"innerWidth": 1903,
"innerHeight": 927,
"deviceScaleFactor": 1
},
"intl": {
"languages": [
"en-US",
"en"
],
"timeZone": "America/New_York"
},
"navigator": {
"hardwareConcurrency": 8,
"deviceMemory": 8
}
}选择国家
支持的国家(47)
传入 country(ISO 3166-1 alpha-2)。语言、Accept-Language 时区、语音和区域字体都会相应匹配设置。
usUnited StatesEnglish
gbUnited KingdomEnglish
caCanadaEnglish / French
auAustraliaEnglish
nzNew ZealandEnglish
ieIrelandEnglish
deGermanyGerman
frFranceFrench
esSpainSpanish
itItalyItalian
nlNetherlandsDutch
beBelgiumDutch / French
chSwitzerlandGerman / French
atAustriaGerman
seSwedenSwedish
noNorwayNorwegian
dkDenmarkDanish
fiFinlandFinnish
plPolandPolish
ptPortugalPortuguese
grGreeceGreek
czCzechiaCzech
roRomaniaRomanian
uaUkraineUkrainian
ruRussiaRussian
trTürkiyeTurkish
brBrazilPortuguese
mxMexicoSpanish
arArgentinaSpanish
clChileSpanish
coColombiaSpanish
jpJapanJapanese
krSouth KoreaKorean
cnChinaChinese (Simplified)
twTaiwanChinese (Traditional)
hkHong KongChinese
sgSingaporeEnglish
inIndiaEnglish / Hindi
idIndonesiaIndonesian
thThailandThai
vnVietnamVietnamese
phPhilippinesEnglish / Filipino
myMalaysiaMalay
zaSouth AfricaEnglish
saSaudi ArabiaArabic
aeUnited Arab EmiratesArabic
ilIsraelHebrew
显示全部 47 个,滚动或搜索
价格
当前的月度套餐和请求限制从公开目录加载。请在控制台中确认你当前的额度。
正在加载最新价格…
常见问题
JSON 会自动更改我的浏览器吗?
不会。你的集成必须逐项应用每个支持的设置。Playwright 的上下文选项可以覆盖部分字段,更深层的信号则需要专门设计来使用它们的浏览器或集成。
指纹的国家/地区与代理的国家/地区相同吗?
不同。指纹设置控制设备和区域信号,代理控制网络出口。当你的工作流需要一致的地区身份时,请让两者保持一致。
如果达到速率限制怎么办?
检查你当前套餐的每分钟请求额度以及组织限制。请对请求进行排队或放慢速度,而不是以相同速率反复重试。
从一开始就建立一致的会话。
生成一个配置、检查字段,并按集成指南应用。
