كل المستندات

واجهة القرارات

مرجع واجهة القرارات: كيف تقيّم نيزا الحدث وتعيد قرار السماح أو المراجعة أو الحظر مع الدرجة والقواعد التي أدت إليه.

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

واجهة القرارات

قيّم المخاطر لحظيًا، ثم ابحث في النتائج التاريخية والإحصاءات باستخدام x-api-key.

الطريقةالمسارالاستخدام
POST/api/v1/decisions/evaluateتقييم حدث وإرجاع قرار لحظي
GET/api/v1/decisions/:idقراءة المدخلات والمخرجات والكيانات المرتبطة
GET/api/v1/decisionsقائمة القرارات مع البحث والتصفية
GET/api/v1/decisions/statsإحصاءات القرارات والدرجات
POST /api/v1/decisions/evaluate
{
  "eventName": "payment.attempt",
  "eventCategory": "TRANSACTION",
  "customer": { "externalId": "cust_123456", "email": "user@example.com" },
  "device": { "externalId": "device_abc123", "fingerprint": "fp_xyz789" },
  "ip": "203.0.113.42",
  "metadata": { "amount": 199.95, "currency": "USD" }
}
Decision response
{
  "decision": "REVIEW",
  "riskScore": 68,
  "riskLevel": "high",
  "reasonCodes": [{
    "code": "HIGH_RISK_IP",
    "explanation": "IP address has elevated fraud history"
  }],
  "correlationIds": {
    "requestId": "req_abc123xyz",
    "eventId": "evt_ckm9876543210"
  },
  "recommendedActions": [{
    "action": "STEP_UP_VERIFICATION",
    "description": "Require OTP challenge"
  }]
}

قيم القرار والبحث

ALLOW يعني إكمال العملية، وREVIEW يعني طلب تحقق إضافي أو إحالتها للمراجعة، وBLOCK يعني إيقافها حسب سياسة منتجك.

تدعم القائمة التصفية حسب decision وminScore/maxScore وriskLevel وcustomer وdevice وcountry وfrom/to وsearch.