أنشئ بصمة، واحقنها، واندمج مع المستخدمين.
اطلب بصمة متصفح متّسقة وواقعية عبر استدعاء REST بسيط، ثم طبّق حقولها على Playwright أو Puppeteer أو Selenium لتُظهر أتمتتك جهازًا واحدًا معقولًا ومتّسقًا.
1. البدء
احصل على مفتاح API من لوحة التحكم، ثم اطلب بصمة. تنشئ /generate هوية جديدة وفريدة؛ وتُرجع /random هوية حقيقية من المجموعة.
# 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 ومنفذ العرض والإعدادات المحلية والمنطقة الزمنية) على المتصفح، ثم طابق navigator الظاهر لـ JS مع الجهاز نفسه قبل تشغيل أي سكربت في الصفحة.
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 وتلميحات العميل) حيث لا يكشفها المتصفح الحقيقي.
3. تنسيقات الاستجابة
chromium جاهز للحقن
الحقول المحددة التي تضبطها على المتصفح: userAgent وscreen وintl وnavigator وwebgl. استخدمه في الأمثلة أعلاه.
raw بيانات كاملة
حمولة البصمة الكاملة (canvas وfonts وvisitor_id وwebgl_properties) للتخزين أو لأداة الحقن الخاصة بك.
4. حافظ على الاتّساق
البصمة جهاز حقيقي واحد معقول، وليست مجموعة حقول عشوائية. قاعدتان تجعلانها مقنعة:
اضبط userAgent وتلميحات العميل وnavigator من الاستجابة نفسها. تجاوز UA بينما تُبلغ تلميحات العميل عن المتصفح الأصلي هو العلامة الكاشفة الأولى للأتمتة.
أعد استخدام البصمة نفسها لملف تعريف أو جلسة معيّنة. تغيير الحقول أثناء الجلسة يبدو كجهاز غيّر عتاده.
اربط الدولة التي تطلبها بعنوان IP للخروج في تلك الدولة لتتوافق المنطقة الزمنية واللغة وعنوان IP.
5. الأسئلة الشائعة
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 مع ترك تلميحات العميل تُبلغ عن المتصفح الأصلي، لذا طبّق الحقول معًا ولا تعدّل أحدها يدويًا بمعزل عن الباقي.
كيف أستهدف دولة أو نظام تشغيل؟›
مرّر country (رمز ISO alpha-2، يحدد اللغات والمنطقة الزمنية والأصوات) وtags (Windows وmacOS وLinux وAndroid وiOS). راجع جدول المعاملات في صفحة Fingerprint API.
هل أنت مستعد للبدء؟
احصل على مفتاح API وأنشئ أول بصمة متّسقة.