نظرة عامة
عنوان الأساس، المصادقة، أنواع القرار، درجات المخاطر، وحدود المعدل.
نظرة عامة
نيزا توفر واجهة RESTful 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
النافذة
ساعة واحدة (متدحرجة)
1 hour (rolling)
زمن الاستجابة (Response Time)
النموذجي
50-200ms
المئين 99
<500ms