Przejdź do treści
Jak korzystać z Fingerprint API

Wygeneruj fingerprint, wstrzyknij go, wtop się w tłum.

Pobierz spójny, prawdziwy fingerprint przeglądarki prostym wywołaniem REST, a następnie zastosuj jego pola w Playwright, Puppeteer lub Selenium, aby Twoja automatyzacja przedstawiała się jako jedna wiarygodna, spójna maszyna.

1. Pierwsze kroki

Pobierz klucz API z panelu, a następnie poproś o fingerprint. /generate syntetyzuje nową, unikalną tożsamość, a /random zwraca prawdziwą tożsamość z puli.

generate.sh
# Generate a fresh, coherent fingerprint (quota deducts on success)
curl "https://api.capzy.ai/fingerprint/generate?key=YOUR_API_KEY&format=chromium&tags=Windows&country=us"
  • Filtruj za pomocą tags (Windows, macOS, Linux, Android, iOS) i country (ISO alpha-2).
  • format=chromium zwraca pola gotowe do wstrzyknięcia, a format=raw zwraca pełne dane.
  • Limit jest pomniejszany tylko przy udanym wygenerowaniu.

2. Zastosuj go w automatyzacji

Ustaw w przeglądarce pola na poziomie maszyny (userAgent, viewport, locale, timezone), a następnie dopasuj widoczny dla JS navigator do tej samej maszyny, zanim uruchomi się jakikolwiek skrypt strony.

playwright.py
import requests
from playwright.sync_api import sync_playwright

# 1. Generate a coherent fingerprint for a Windows visitor in the US
fp = requests.get("https://api.capzy.ai/fingerprint/generate", params={
    "key": "YOUR_API_KEY",
    "format": "chromium",   # injection-ready
    "tags": "Windows",
    "country": "us",
}).json()

rect = fp["screen"]["screenRect"]

with sync_playwright() as p:
    browser = p.chromium.launch()
    # 2. Apply the machine-level fields on the context
    context = browser.new_context(
        user_agent=fp["userAgent"]["userAgent"],
        locale=fp["intl"]["languages"][0],
        timezone_id=fp["intl"]["timeZone"],
        viewport={"width": rect["width"], "height": rect["height"]},
        device_scale_factor=fp["screen"]["deviceScaleFactor"],
    )
    # 3. Match the JS-visible navigator to the SAME machine (before page scripts)
    context.add_init_script(f"""
      Object.defineProperty(navigator, 'hardwareConcurrency', {{ get: () => {fp['navigator']['hardwareConcurrency']} }});
      Object.defineProperty(navigator, 'deviceMemory', {{ get: () => {fp['navigator']['deviceMemory']} }});
      Object.defineProperty(navigator, 'platform', {{ get: () => '{fp['userAgent']['platform']}' }});
    """)
    page = context.new_page()
    page.goto("https://example.com")
    print(page.title())
    browser.close()

Fingerprinty Firefox i Safari działają tak samo. Pola możliwości dostępne w Chromium (deviceMemory, hardwareConcurrency, client hints) są pomijane tam, gdzie prawdziwa przeglądarka by ich nie udostępniała.

3. Formaty odpowiedzi

chromium gotowy do wstrzyknięcia

Dokładnie te pola, które ustawiasz w przeglądarce: userAgent, screen, intl, navigator, webgl. Użyj go w powyższych przykładach.

raw pełne dane

Kompletny ładunek fingerprintu (canvas, fonts, visitor_id, webgl_properties) do przechowywania lub własnego mechanizmu wstrzykiwania.

4. Zachowaj spójność

Fingerprint to jedna wiarygodna, prawdziwa maszyna, a nie worek losowych pól. Dwie zasady sprawiają, że pozostaje przekonujący:

Stosuj pola razem

Ustawiaj userAgent, client hints i navigator z tej samej odpowiedzi. Nadpisanie UA, gdy client hints zgłaszają oryginalną przeglądarkę, to najczęstsza oznaka automatyzacji.

Jeden fingerprint na tożsamość

Używaj tego samego fingerprintu dla danego profilu lub sesji. Zmiana pól w trakcie sesji wygląda jak maszyna, która zmieniła sprzęt.

Dopasuj geografię proxy

Połącz wybrany kraj z wyjściowym IP z tego samego kraju, aby strefa czasowa, język i IP były zgodne.

5. FAQ

random czy generate: który endpoint?›

/fingerprint/random zwraca prawdziwe, wcześniej zebrane urządzenie z puli (tanio). /fingerprint/generate syntetyzuje nowe, unikalne urządzenie przy ścisłych ograniczeniach spójności (limit jest pomniejszany tylko przy sukcesie). Użyj generate, gdy potrzebujesz jedynej w swoim rodzaju tożsamości.

Format chromium czy raw?›

chromium jest gotowy do wstrzyknięcia: dokładnie te pola, które ustawiasz w przeglądarce (userAgent, screen, intl, navigator). raw zwraca pełne dane fingerprintu (canvas, fonts, visitor_id, webgl_properties) do przechowywania lub własnego mechanizmu wstrzykiwania.

Czy muszę też ustawić nagłówki Sec-CH-UA?›

Fingerprint jest wyprowadzany jako jedna maszyna, więc userAgent, nagłówki client hints i navigator są ze sobą zgodne. Najczęstszą wpadką jest nadpisanie UA przy pozostawieniu client hints, które zgłaszają oryginalną przeglądarkę, więc stosuj pola razem i nie edytuj ręcznie żadnego z osobna.

Jak wybrać kraj lub system?›

Przekaż country (ISO alpha-2, steruje językami, strefą czasową i głosami) oraz tags (Windows, macOS, Linux, Android, iOS). Zobacz tabelę parametrów na stronie Fingerprint API.

Gotowy, by zacząć?

Zdobądź klucz API i wygeneruj pierwszy spójny fingerprint.

Zdobądź klucz API