انتقل إلى المحتوى

Capzy Fingerprint API. ابنِ هوية متّسقة.

أنشئ بصمة متصفح بتنسيق JSON. اختر نظام تشغيل ودولة، وأعد استخدام الهوية عند عودة الجلسة، واربط المخرجات بالإعدادات التي يدعمها متصفحك.

هوية واحدة، وإشارات مترابطةمثال توضيحي
معرّف ثابتcustomer-123
عائلة الجهازWindows · Chromium · 1920 × 1080
الإعدادات المحلية + المنطقة الزمنيةen-US / America/New_York
مجموعات المخرجاتUser agent والشاشة وnavigator والرسوميات والمزيد

أنشئ ملف تعريف، ثم طبّق إعداداته

ابدأ بطلب بصمة. استخدم حقول الاستجابة التي يدعمها إطار الأتمتة لديك؛ فتنزيل JSON لا يطبّق كل إشارات المتصفح تلقائيًا.

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. فعّل API وانسخ مفتاحك

    اختر خطة Fingerprint API نشطة واستخدم مفتاح Capzy API من حسابك. خزّنه باسم CAPZY_API_KEY.

    افتح Fingerprint API
  2. اختر قيود الهوية

    أرسل format=chromium ووسم نظام التشغيل ورمز الدولة. أعد استخدام id أو uuid أو seed مع الخيارات نفسها لإعادة إنشاء الهوية.

  3. طبّق الحقول المدعومة على متصفحك

    يطبّق مثال Playwright قيم user agent والإعدادات المحلية والمنطقة الزمنية ومنفذ العرض. تحتاج Canvas وWebGL والإشارات الأخرى إلى دعم خاص بالمتصفح؛ راجع الدليل الكامل.

اختر ملف التعريف الذي تحتاجه

المفتاح مطلوب. خيارات الهوية والتصفية اختيارية؛ حافظ على اتّساقها عند إعادة إنشاء ملف تعريف.

keyمطلوب · مفتاح API
مفتاح Capzy API الخاص بك. احتفظ به على الخادم وبعيدًا عن JavaScript في المتصفح والمستودعات العامة وعناوين URL للطلبات المسجّلة.
id / uuid / seedاختياري · الهوية
محددات هوية بديلة. قدّم قيمة ثابتة واحدة وأعد استخدام إعدادات التصفية نفسها لإنشاء حتمي. احذفها للحصول على هوية جديدة.
formatالافتراضي · chromium
اختر chromium لبنية JSON الموجّهة للمتصفح المستخدمة في هذه الأمثلة، أو raw للتمثيل الخام لملف التعريف.
tagsاختياري · نظام التشغيل
صفِّ عائلة الجهاز، مثل Windows أو macOS أو Linux. حافظ على توافق نظام التشغيل المطلوب مع المتصفح الذي تستخدمه.
countryاختياري · رمز من حرفين
يضبط الإعدادات المحلية وتلميحات الملف الإقليمي. دولة البصمة ليست بروكسي؛ اضبط خروج المتصفح بشكل منفصل عندما يهم موقع عنوان IP.
min_browser_version / browser_versionاختياري · قيود الإصدار
صفِّ الإصدارات باستخدام مرجع API الكامل. يوفّر build_version وforce_browser_version عناصر تحكم إضافية؛ استخدم قيمًا يدعمها تكامل متصفحك.

اقرأ البصمة على شكل مجموعات

استجابة توضيحية مختصرة. تحتوي استجابة API على البصمة الكاملة وقد تختلف حسب الجهاز والتنسيق.

يطبّق مثال Playwright قيم user agent والإعدادات المحلية والمنطقة الزمنية ومنفذ العرض. تحتاج Canvas وWebGL والإشارات الأخرى إلى دعم خاص بالمتصفح؛ راجع الدليل الكامل.
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
  }
}

اختر دولة

الدول المدعومة (47)

مرّر country (ISO 3166-1 alpha-2). تُضبط اللغة وAccept-Language والمنطقة الزمنية والأصوات وخطوط الإعدادات المحلية كلها لتتطابق.

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

عرض الكل (47)، مرّر أو ابحث

الأسعار

تُحمَّل الخطط الشهرية الحالية وحدود الطلبات من الكتالوج العام. تأكد من حصتك النشطة في لوحة التحكم.

جارٍ تحميل الأسعار الحالية…

أمور ينبغي معرفتها

هل يغيّر JSON متصفحي تلقائيًا؟

لا. يجب أن يطبّق تكاملك كل إعداد مدعوم. تغطي خيارات السياق في Playwright بعض الحقول، بينما تحتاج الإشارات الأعمق إلى متصفح أو تكامل مصمّم لاستهلاكها.

هل دولة البصمة هي نفسها دولة البروكسي؟

لا. تتحكم إعدادات البصمة في إشارات الجهاز والإعدادات المحلية. ويتحكم البروكسي في خروج الشبكة. اجعلهما متوافقين عندما يحتاج مسار عملك إلى هوية إقليمية متّسقة.

ماذا لو بلغت حد المعدل؟

تحقّق من حصة الطلبات في الدقيقة لخطتك النشطة وأي حدود للمؤسسة. ضع الطلبات في قائمة انتظار أو أبطئها بدلًا من إعادة المحاولة المتكررة بالمعدل نفسه.

ابنِ جلسة متّسقة من البداية.

أنشئ ملف تعريف واحدًا، وافحص حقوله، وطبّقها باستخدام دليل التكامل.

فتح لوحة التحكم