ابدأ خلال 5 دقائق
خمس خطوات نحو التعرّف الدقيق على الأجهزة. لا حاجة لبطاقة ائتمان.
أنشئ حسابًا
أنشئ حسابك في ثوانٍ. لا حاجة لبطاقة ائتمان. احصل على 2,500 استدعاء API مجاني شهريًا.
احصل على المفتاح العام
انسخ مفتاحك العام من لوحة المعلومات. إنه سلسلة سداسية عشرية من 40 حرفًا، آمنة للشحن في كود جانب العميل.
ثبّت SDK
أضف مكتبة العميل @tracio/sdk. راجع دليل البدء السريع للحصول على الحزم الخاصة بكل إطار عمل.
$ npm install @tracio/sdkتستخدم إطار عمل؟ راجع دليل البدء السريع للحصول على حزم React وVue وAngular وSvelte.
تعرّف على زائر
هيّئ باستخدام Tracio.init()، ثم استدعِ tracio.getResult() لاستلام معرّف زائر فريد ونتيجة كشف الروبوتات.
import { Tracio } from '@tracio/sdk'
// Initialize the SDK
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
// Get the visitor identification
const result = await tracio.getResult()تحقّق
تأكّد من وصول الحدث إلى جانب الخادم. يُسلّم TRACIO كل عملية تعرّف إلى نقطة النهاية لديك على هيئة webhook موقّع، وكل حدث مرئي أيضًا في لوحة المعلومات.
X-Tracio-Signature: t=1710432000,v1=5257a869…
{
"requestId": "1710432000_abc123def",
"visitorId": "X7fh2Hg9LkMn3pQr",
"bot": { "result": "human", "score": 0.02 },
"identification": { "confidence": 0.95 },
"geo": { "country": "CZ", "city": "Prague" }
}تحقّق من HMAC في X-Tracio-Signature، ثم تصرّف بناءً على الحمولة. راجع Webhooks للاطّلاع على الحمولة الكاملة والتحقق من التوقيع.
استكشاف الأخطاء وإصلاحها
هل يفشل npm install؟
تأكّد من تشغيلك Node.js الإصدار v16 أو أحدث. شغّل node --version للتحقق.
المفتاح العام لا يعمل؟
تأكّد من أن مفتاحك هو المفتاح العام المكوّن من 40 حرفًا الخاص بمساحة العمل التي تعمل بها.
نتيجة فارغة؟
تحقّق من أن إعدادات المنطقة لديك تطابق المنطقة التي اخترتها أثناء التسجيل.
خطأ CORS؟
استخدم إعداد تكامل البروكسي لتوجيه الطلبات عبر نطاقك الخاص.
هل أنت مستعد للبدء؟
أنشئ حسابك المجاني وابدأ التعرّف على الزوار في أقل من 5 دقائق.