كل المستندات

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

تقييم approve وdeny وreview وحمولات القرار (واجهة الأحداث تستخدم ALLOW وREVIEW وBLOCK).

تنزيل 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.