Chuyển đến nội dung

Capzy Fingerprint API. Xây dựng một danh tính nhất quán.

Tạo fingerprint trình duyệt dưới dạng JSON. Chọn hệ điều hành và quốc gia, dùng lại danh tính khi một phiên quay lại, và ánh xạ đầu ra vào các thiết lập được trình duyệt hỗ trợ.

Một danh tính, các tín hiệu liên quanVí dụ minh họa
ID cố địnhcustomer-123
Họ thiết bịWindows · Chromium · 1920 × 1080
Locale + múi giờen-US / America/New_York
Nhóm đầu raUser agent, màn hình, navigator, đồ họa và nhiều hơn nữa

Tạo profile, sau đó áp dụng các thiết lập

Bắt đầu với một request fingerprint. Dùng các trường phản hồi mà framework tự động hóa của bạn hỗ trợ; tải JSON về không tự động áp dụng mọi tín hiệu trình duyệt.

generate_fingerprint.py
# 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"])
  1. Kích hoạt API và sao chép key

    Chọn một gói Fingerprint API đang hoạt động và dùng một API key Capzy từ tài khoản của bạn. Lưu thành CAPZY_API_KEY.

    Mở Fingerprint API
  2. Chọn các ràng buộc danh tính

    Gửi format=chromium, một tag hệ điều hành và một mã quốc gia. Dùng lại id, uuid hoặc seed với cùng tùy chọn để tạo lại một danh tính.

  3. Áp dụng các trường được hỗ trợ vào trình duyệt

    Ví dụ Playwright áp dụng user agent, locale, múi giờ và viewport. Canvas, WebGL và các tín hiệu khác cần hỗ trợ riêng cho từng trình duyệt; xem hướng dẫn đầy đủ.

Chọn profile bạn cần

Key là bắt buộc. Các tùy chọn danh tính và lọc là không bắt buộc; hãy giữ chúng nhất quán khi tạo lại profile.

keyBắt buộc · API key
API key Capzy của bạn. Giữ nó ở máy chủ, không để trong JavaScript của trình duyệt, repository công khai hoặc URL request được ghi log.
id / uuid / seedKhông bắt buộc · danh tính
Các bộ chọn danh tính thay thế. Cung cấp một giá trị cố định và dùng lại cùng cấu hình bộ lọc để tạo kết quả xác định. Bỏ qua để có danh tính mới.
formatMặc định · chromium
Chọn chromium cho cấu trúc JSON hướng trình duyệt được dùng trong các ví dụ này, hoặc raw cho dạng biểu diễn profile thô.
tagsKhông bắt buộc · hệ điều hành
Lọc họ thiết bị, ví dụ Windows, macOS hoặc Linux. Giữ hệ điều hành được yêu cầu nhất quán với trình duyệt bạn dùng.
countryKhông bắt buộc · mã hai chữ cái
Đặt locale và gợi ý profile theo khu vực. Quốc gia của fingerprint không phải là proxy; hãy cấu hình egress trình duyệt riêng khi vị trí IP quan trọng.
min_browser_version / browser_versionKhông bắt buộc · ràng buộc phiên bản
Lọc phiên bản theo tài liệu tham chiếu API đầy đủ. build_version và force_browser_version cung cấp thêm các tùy chọn kiểm soát; hãy dùng giá trị mà tích hợp trình duyệt của bạn hỗ trợ.

Đọc fingerprint theo nhóm

Phản hồi minh họa được rút gọn. Phản hồi API của bạn chứa fingerprint đầy đủ và có thể khác nhau tùy thiết bị và định dạng.

Ví dụ Playwright áp dụng user agent, locale, múi giờ và viewport. Canvas, WebGL và các tín hiệu khác cần hỗ trợ riêng cho từng trình duyệt; xem hướng dẫn đầy đủ.
fingerprint.example.json
{
  "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
  }
}

Chọn quốc gia

Các quốc gia được hỗ trợ (47)

Truyềncountry (ISO 3166-1 alpha-2). Ngôn ngữ,Accept-Language múi giờ, giọng đọc và phông chữ theo locale đều được đặt cho khớp.

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

Đang hiển thị tất cả 47, cuộn hoặc tìm kiếm

Bảng giá

Các gói tháng và giới hạn request hiện tại được tải từ danh mục công khai. Hãy xác nhận hạn mức đang hoạt động của bạn trong bảng điều khiển.

Đang tải giá hiện tại…

Một vài điều cần biết

JSON có tự động thay đổi trình duyệt của tôi không?

Không. Tích hợp của bạn phải áp dụng từng thiết lập được hỗ trợ. Các tùy chọn context của Playwright bao gồm một số trường, còn các tín hiệu sâu hơn cần trình duyệt hoặc tích hợp được thiết kế để sử dụng chúng.

Quốc gia của fingerprint có giống quốc gia của proxy không?

Không. Thiết lập fingerprint kiểm soát tín hiệu thiết bị và locale. Proxy kiểm soát egress mạng. Hãy giữ chúng khớp nhau khi quy trình của bạn cần một danh tính khu vực nhất quán.

Nếu tôi chạm rate limit thì sao?

Kiểm tra hạn mức request mỗi phút của gói đang hoạt động và mọi giới hạn của tổ chức. Hãy đưa vào hàng đợi hoặc giảm tốc độ request thay vì liên tục thử lại với cùng tốc độ.

Xây dựng một phiên nhất quán ngay từ đầu.

Tạo một profile, kiểm tra các trường và áp dụng chúng theo hướng dẫn tích hợp.

Mở bảng điều khiển