Naar inhoud springen

Capzy Fingerprint API. Bouw een consistente identiteit.

Genereer een browserfingerprint als JSON. Kies een besturingssysteem en land, hergebruik een identiteit wanneer een sessie terugkomt en vertaal de uitvoer naar de ondersteunde instellingen van je browser.

Eén identiteit, samenhangende signalenIllustratief voorbeeld
Stabiel IDcustomer-123
ApparaatfamilieWindows · Chromium · 1920 × 1080
Locale + tijdzoneen-US / America/New_York
UitvoergroepenUser agent, scherm, navigator, graphics en meer

Genereer een profiel en pas daarna de instellingen toe

Begin met een fingerprintverzoek. Gebruik de velden in het antwoord die je automatiseringsframework ondersteunt; door JSON te downloaden wordt niet automatisch elk browsersignaal toegepast.

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. Activeer de API en kopieer je sleutel

    Kies een actief Fingerprint API-abonnement en gebruik een Capzy API-sleutel uit je account. Sla hem op als CAPZY_API_KEY.

    Fingerprint API openen
  2. Kies de randvoorwaarden voor de identiteit

    Stuur format=chromium, een OS-tag en een landcode. Hergebruik id, uuid of seed met dezelfde opties om een identiteit opnieuw te genereren.

  3. Pas ondersteunde velden toe op je browser

    Het Playwright-voorbeeld past user agent, locale, tijdzone en viewport toe. Canvas, WebGL en andere signalen vereisen browserspecifieke ondersteuning; zie de volledige handleiding.

Kies het profiel dat je nodig hebt

De sleutel is verplicht. Opties voor identiteit en filtering zijn optioneel; houd ze gelijk wanneer je een profiel opnieuw genereert.

keyVerplicht · API-sleutel
Je Capzy API-sleutel. Houd hem op de server en uit browser-JavaScript, openbare repositories en gelogde verzoek-URL's.
id / uuid / seedOptioneel · identiteit
Alternatieve identiteitsselectors. Geef één stabiele waarde mee en hergebruik dezelfde filterconfiguratie voor deterministische generatie. Laat ze weg voor een nieuwe identiteit.
formatStandaard · chromium
Kies chromium voor de browsergerichte JSON-structuur die in deze voorbeelden wordt gebruikt, of raw voor de ruwe weergave van het profiel.
tagsOptioneel · OS
Filter de apparaatfamilie, bijvoorbeeld Windows, macOS of Linux. Houd het aangevraagde besturingssysteem in lijn met de browser die je gebruikt.
countryOptioneel · code van twee letters
Stel locale en regionale profielhints in. Een fingerprintland is geen proxy; configureer browser-egress apart als de IP-locatie ertoe doet.
min_browser_version / browser_versionOptioneel · versievoorwaarden
Filter versies met de volledige API-referentie. build_version en force_browser_version bieden extra controle; gebruik waarden die je browserintegratie ondersteunt.

Lees een fingerprint in groepen

Een ingekort, illustratief antwoord. Je API-antwoord bevat de volledige fingerprint en kan per apparaat en formaat verschillen.

Het Playwright-voorbeeld past user agent, locale, tijdzone en viewport toe. Canvas, WebGL en andere signalen vereisen browserspecifieke ondersteuning; zie de volledige handleiding.
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
  }
}

Kies een land

Ondersteunde landen (47)

Geef country mee (ISO 3166-1 alpha-2). Taal, Accept-Language, tijdzone, spraakstemmen en locale-fonts worden allemaal daarop afgestemd.

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

Alle 47 weergegeven, scroll of zoek

Prijzen

De actuele maandabonnementen en verzoeklimieten worden geladen uit de openbare catalogus. Controleer je actieve tegoed in het dashboard.

Actuele prijzen laden…

Goed om te weten

Past de JSON mijn browser automatisch aan?

Nee. Je integratie moet elke ondersteunde instelling toepassen. De contextopties van Playwright dekken een aantal velden, terwijl diepere signalen een browser of integratie vereisen die daarvoor is gemaakt.

Is een fingerprintland hetzelfde als een proxyland?

Nee. Fingerprintinstellingen bepalen apparaat- en localesignalen. Een proxy bepaalt de netwerk-egress. Houd ze op elkaar afgestemd als je workflow een consistente regionale identiteit nodig heeft.

Wat als ik een rate limit bereik?

Controleer het tegoed aan verzoeken per minuut van je actieve abonnement en eventuele limieten van je organisatie. Zet verzoeken in een wachtrij of vertraag ze, in plaats van steeds opnieuw met hetzelfde tempo te proberen.

Bouw vanaf het begin een consistente sessie.

Genereer één profiel, bekijk de velden en pas ze toe met behulp van de integratiehandleiding.

Dashboard openen