Capzy Fingerprint API. ابنِ هوية متّسقة.
أنشئ بصمة متصفح بتنسيق JSON. اختر نظام تشغيل ودولة، وأعد استخدام الهوية عند عودة الجلسة، واربط المخرجات بالإعدادات التي يدعمها متصفحك.
customer-123en-US / America/New_Yorkأنشئ ملف تعريف، ثم طبّق إعداداته
ابدأ بطلب بصمة. استخدم حقول الاستجابة التي يدعمها إطار الأتمتة لديك؛ فتنزيل JSON لا يطبّق كل إشارات المتصفح تلقائيًا.
# 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"])فعّل API وانسخ مفتاحك
اختر خطة Fingerprint API نشطة واستخدم مفتاح Capzy API من حسابك. خزّنه باسم CAPZY_API_KEY.
افتح Fingerprint APIاختر قيود الهوية
أرسل format=chromium ووسم نظام التشغيل ورمز الدولة. أعد استخدام id أو uuid أو seed مع الخيارات نفسها لإعادة إنشاء الهوية.
طبّق الحقول المدعومة على متصفحك
يطبّق مثال 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 على البصمة الكاملة وقد تختلف حسب الجهاز والتنسيق.
{
"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 والمنطقة الزمنية والأصوات وخطوط الإعدادات المحلية كلها لتتطابق.
عرض الكل (47)، مرّر أو ابحث
الأسعار
تُحمَّل الخطط الشهرية الحالية وحدود الطلبات من الكتالوج العام. تأكد من حصتك النشطة في لوحة التحكم.
جارٍ تحميل الأسعار الحالية…
أمور ينبغي معرفتها
هل يغيّر JSON متصفحي تلقائيًا؟
لا. يجب أن يطبّق تكاملك كل إعداد مدعوم. تغطي خيارات السياق في Playwright بعض الحقول، بينما تحتاج الإشارات الأعمق إلى متصفح أو تكامل مصمّم لاستهلاكها.
هل دولة البصمة هي نفسها دولة البروكسي؟
لا. تتحكم إعدادات البصمة في إشارات الجهاز والإعدادات المحلية. ويتحكم البروكسي في خروج الشبكة. اجعلهما متوافقين عندما يحتاج مسار عملك إلى هوية إقليمية متّسقة.
ماذا لو بلغت حد المعدل؟
تحقّق من حصة الطلبات في الدقيقة لخطتك النشطة وأي حدود للمؤسسة. ضع الطلبات في قائمة انتظار أو أبطئها بدلًا من إعادة المحاولة المتكررة بالمعدل نفسه.
ابنِ جلسة متّسقة من البداية.
أنشئ ملف تعريف واحدًا، وافحص حقوله، وطبّقها باستخدام دليل التكامل.
