كل المستندات

نظرة عامة

نظرة عامة على واجهة نيزا: عنوان الواجهة الأساسي، والمصادقة، وقرارات السماح أو المراجعة أو الحظر، ودرجات المخاطر، وحدود عدد الطلبات.

تنزيل Markdown
الأدلةمرجع APIأمثلة الكودأفضل الممارسات

نظرة عامة

توفر نيزا واجهة REST API بصيغة JSON لكشف الاحتيال لحظيًا. أرسل الأحداث مع بيانات العميل والجهاز والجلسة، واحصل فورًا على قرار ALLOW / BLOCK / REVIEW مع درجة المخاطر والقواعد المطابقة.

عنوان الأساس (Base URL)

https://api.naiza.ai/api/v1

المصادقة

تتطلب جميع طلبات API إرسال المفتاح في ترويسة x-api-key. صيغة المفاتيح: naiza_api_sk_live_... للإنتاج أو naiza_api_sk_test_... للاختبار.

Authentication example
curl -X POST https://api.naiza.ai/api/v1/events \
  -H "x-api-key: naiza_api_sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"eventName": "user.login", ...}'

أنواع القرار

ALLOW
لم تُكتشف إشارات احتيال
أكمل العملية بشكل طبيعي
REVIEW
وُجدت مؤشرات مشبوهة
اطلب تحققًا إضافيًا (مثل MFA)
BLOCK
احتيال مرجّح بدرجة ثقة عالية
امنع العملية فورًا

تُحدَّد القرارات وفق القواعد التي أعددتها. قواعد BLOCK تُنهي التقييم فورًا، ويصدر قرار REVIEW عند تطابق قاعدة مراجعة أو عند وصول مجموع الدرجات إلى الحد المحدد.

درجة المخاطر (Risk Score)

تُجمع درجات المخاطر من القواعد من نوع SCORE أثناء التقييم، وإذا بلغ المجموع 100 أو أكثر يصدر قرار REVIEW.

النطاقالمستوىالوصف
0-25منخفض (Low)سلوك طبيعي مع مؤشرات احتيال محدودة
26-50متوسط (Medium)وجود بعض المؤشرات المشبوهة
51-75مرتفع (High)رُصدت عدة مؤشرات احتيال
76-100+حرج (Critical)إشارات احتيال قوية — الدرجة ≥ 100 تؤدي إلى قرار REVIEW

حدود عدد الطلبات (Rate Limits)

تخضع طلبات API لحصة محددة لكل حساب منشأة، وعند تجاوزها تُعاد الحالة 429مع ترويسة Retry-After.

الحصة الافتراضية
10,000 req/hr
الفترة الزمنية
ساعة واحدة (تُحسب على آخر 60 دقيقة)
1 hour (rolling)

زمن الاستجابة (Response Time)

يوضح حقل مدة المعالجة الوقت المستغرق لكل طلب، ويمكنك الاعتماد عليه لمتابعة أداء التكامل.