सामग्री पर जाएं
Fingerprint API का उपयोग कैसे करें

फ़िंगरप्रिंट बनाएं, इंजेक्ट करें, घुल-मिल जाएं।

एक सरल REST कॉल से सुसंगत, वास्तविक ब्राउज़र फ़िंगरप्रिंट का अनुरोध करें, फिर उसके फ़ील्ड Playwright, Puppeteer या Selenium पर लागू करें ताकि आपका ऑटोमेशन एक विश्वसनीय, सुसंगत मशीन के रूप में दिखे।

1. शुरुआत

अपने डैशबोर्ड से एक API कुंजी लें, फिर फ़िंगरप्रिंट का अनुरोध करें। /generate एक नई, यूनिक पहचान बनाता है; /random पूल से एक असली पहचान लौटाता है।

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"
  • tags (Windows, macOS, Linux, Android, iOS) और country (ISO alpha-2) से फ़िल्टर करें।
  • format=chromium इंजेक्शन के लिए तैयार फ़ील्ड लौटाता है; format=raw पूरा डेटा लौटाता है।
  • कोटा केवल सफल जनरेशन पर कटता है।

2. इसे अपने ऑटोमेशन में लागू करें

ब्राउज़र पर मशीन-स्तर के फ़ील्ड (userAgent, viewport, locale, timezone) सेट करें, फिर किसी भी पेज स्क्रिप्ट के चलने से पहले JS में दिखने वाले navigator को उसी मशीन से मिलाएं।

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()

Firefox और Safari फ़िंगरप्रिंट भी इसी तरह काम करते हैं। Chromium पर मौजूद क्षमता फ़ील्ड (deviceMemory, hardwareConcurrency, client hints) वहां छोड़ दिए जाते हैं जहां असली ब्राउज़र उन्हें उजागर नहीं करता।

3. रिस्पॉन्स फ़ॉर्मेट

chromium इंजेक्शन के लिए तैयार

ठीक वही फ़ील्ड जो आप ब्राउज़र पर सेट करते हैं: userAgent, screen, intl, navigator, webgl। ऊपर के उदाहरणों के लिए इसे इस्तेमाल करें।

raw पूरा डेटा

स्टोरेज या आपके अपने इंजेक्टर के लिए पूरा फ़िंगरप्रिंट पेलोड (canvas, fonts, visitor_id, webgl_properties)।

4. इसे सुसंगत रखें

एक फ़िंगरप्रिंट एक विश्वसनीय असली मशीन है, बेतरतीब फ़ील्ड का थैला नहीं। दो नियम इसे भरोसेमंद बनाए रखते हैं:

फ़ील्ड एक साथ लागू करें

userAgent, client hints और navigator एक ही रिस्पॉन्स से सेट करें। क्लाइंट हिंट के मूल ब्राउज़र बताते रहने के दौरान UA बदलना ऑटोमेशन की सबसे बड़ी पहचान है।

हर पहचान के लिए एक फ़िंगरप्रिंट

किसी प्रोफ़ाइल/सेशन के लिए वही फ़िंगरप्रिंट दोबारा इस्तेमाल करें। सेशन के बीच फ़ील्ड बदलना ऐसा दिखता है जैसे मशीन का हार्डवेयर बदल गया हो।

प्रॉक्सी का भूगोल मिलाएं

अनुरोधित देश के साथ उसी देश का इग्रेस IP इस्तेमाल करें ताकि टाइमज़ोन, भाषा और IP मेल खाएं।

5. FAQ

random बनाम generate: कौन सा एंडपॉइंट?›

/fingerprint/random पूल से पहले इकट्ठा किया गया एक असली डिवाइस लौटाता है (सस्ता)। /fingerprint/generate सख्त सुसंगतता शर्तों के तहत एक नया, यूनिक डिवाइस बनाता है (कोटा केवल सफलता पर कटता है)। जब आपको एक अनोखी पहचान चाहिए तो generate इस्तेमाल करें।

chromium बनाम raw फ़ॉर्मेट?›

chromium इंजेक्शन के लिए तैयार है: ठीक वही फ़ील्ड जो आप ब्राउज़र पर सेट करते हैं (userAgent, screen, intl, navigator)। raw स्टोरेज या आपके अपने इंजेक्टर के लिए पूरा फ़िंगरप्रिंट डेटा (canvas, fonts, visitor_id, webgl_properties) लौटाता है।

क्या मुझे Sec-CH-UA हेडर भी सेट करने होंगे?›

फ़िंगरप्रिंट एक ही मशीन के रूप में बनाया जाता है, इसलिए userAgent, क्लाइंट-हिंट हेडर और navigator सभी मेल खाते हैं। सबसे बड़ी पहचान यह है कि UA बदल दिया जाए लेकिन क्लाइंट हिंट मूल ब्राउज़र ही बताते रहें, इसलिए फ़ील्ड एक साथ लागू करें और किसी एक को अलग से हाथ से न बदलें।

मैं किसी देश या OS को कैसे टार्गेट करूं?›

country (ISO alpha-2, भाषाएं + टाइमज़ोन + वॉइस तय करता है) और tags (Windows, macOS, Linux, Android, iOS) पास करें। Fingerprint API पेज पर पैरामीटर टेबल देखें।

शुरू करने के लिए तैयार हैं?

एक API कुंजी पाएं और अपना पहला सुसंगत फ़िंगरप्रिंट बनाएं।

अपनी API कुंजी पाएं