كل المستندات

مراقبة الأحداث

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

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

تكامل مراقبة الأحداث

استخدم مراقبة الأحداث لتقيّم نيزا النشاط في منتجك لحظة حدوثه: التسجيل، وتسجيل الدخول، والمدفوعات، والسحوبات، وتعديل بيانات الحساب، وغيرها من الإجراءات التي قد تنطوي على مخاطر احتيال.

المسار الأساسي

  1. أرسل الحدث إلى نيزا بصيغة موحّدة.
  2. تضيف نيزا إلى الحدث بيانات مساندة وتقيّمه وفق القواعد المعتمدة في حساب منشأتك.
  3. طبّق القرار الذي يصلك: ALLOW أو BLOCK أو REVIEW.
  4. أرسل ملاحظات بعد أن يؤكد فريق العمليات النتيجة.

اختر طريقة التكامل

قرار متزامن

استخدم POST /api/v1/decisions/evaluate عندما تحتاج العملية في منتجك إلى قرار فوري قبل إكمالها.

Synchronous
POST /api/v1/decisions/evaluate

{
  "eventName": "payment.attempt",
  "eventCategory": "TRANSACTION",
  "customer": {
    "externalId": "cust_123",
    "email": "user@example.com"
  },
  "device": {
    "externalId": "device_abc123",
    "fingerprint": "fp_abc123"
  },
  "ip": "203.0.113.42",
  "sessionId": "session_xyz789",
  "metadata": {
    "amount": 250,
    "currency": "SAR",
    "paymentMethod": "card"
  }
}

مراقبة غير متزامنة

استخدم POST /api/v1/events أو POST /api/v1/events/async عندما لا يحتاج منتجك إلى انتظار القرار.

Asynchronous
POST /api/v1/events/async

{
  "eventName": "user.login",
  "eventCategory": "AUTHENTICATION",
  "customer": { "externalId": "cust_123" },
  "device": { "externalId": "device_abc123" },
  "ip": "203.0.113.42",
  "country": "SA",
  "sessionId": "session_xyz789"
}

تصميم الأحداث بشكل متسق

اجعل أسماء الأحداث ثابتة وتعكس نوع النشاط بوضوح، مثل user.signup أو payment.attempt أو withdrawal.requested.

  • customer.externalId — معرّف العميل الثابت في نظامك.
  • device.externalId أو device.fingerprint — معرّف ثابت للجهاز.
  • sessionId — يربط النشاط الذي يتم خلال زيارة واحدة.
  • metadata — حقول خاصة بمنتجك يمكن أن تعتمد عليها القواعد.

من القواعد إلى القرار

تقيّم القواعد بيانات الحدث وتحدد الإجراء المناسب. خصّص BLOCK للإشارات التي تدل على احتيال بدرجة ثقة عالية، وREVIEW للإشارات غير الحاسمة، وALLOW للنشاط الطبيعي.

اختر أسماء واضحة ومفهومة للقواعد، لأنها تظهر لفريق العمليات أثناء المراجعة وعند إرسال الملاحظات.

متابعة النتائج

احفظ معرفات الاستجابة من القرارات المتزامنة واستخدم correlationIds.eventId عند الاستعلام عن حدث أو إرسال ملاحظات.

Decision identifiers
{
  "decision": "REVIEW",
  "riskScore": 82,
  "correlationIds": {
    "requestId": "req_abc123xyz",
    "eventId": "evt_ckm9876543210"
  }
}
Feedback
POST /api/v1/feedback/event/:id

{
  "label": "FRAUD",
  "notes": "Customer confirmed the payment was unauthorized",
  "externalCaseId": "case_12345"
}