الانتقال إلى المحتوى الرئيسي
GET
curl
تُحفظ الأحداث ضمن فئات الاحتفاظ، لذا لا يظهر الحدث هنا بعد انتهاء فئته. راجع استيعاب الأحداث للاطلاع على مرجع التصفية، والقواعد المطبقة على الأحداث لمعرفة ما يغيّر قيمة rules_matched_count.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات الاستعلام

limit
integer
افتراضي:50

الحد الأقصى لعدد الأحداث لكل صفحة. القيمة الافتراضية هي 50. تُرْجِع القيم التي تزيد عن 1000000 الرمز 400؛ وأي قيمة غير عددية أو صفرية أو سالبة تعود تلقائياً إلى 50.

النطاق المطلوب: 1 <= x <= 1000000
offset
integer
افتراضي:0

عدد الأحداث المراد تخطيها. القيمة الافتراضية هي 0. يُفضّل تتبّع رابط next من الاستجابة.

النطاق المطلوب: 0 <= x <= 1000000
event_category
enum<string>[]

الأحداث في هذه الفئات فقط. كرر المعامل لعدة قيم (?event_category=payment&event_category=dispute)؛ ويتم إرجاع أي حدث يطابق أيًا منها.

الخيارات المتاحة:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
action_type
string[]

فقط الأحداث التي تتضمن أنواع الإجراءات هذه (مطابقة تامة، حساسة لحالة الأحرف). كرر لعدة قيم.

status
enum<string>[]

فقط الأحداث التي لها هذه الحالات. كرر لعدة قيم.

الخيارات المتاحة:
ACCEPTED,
APPROVED,
IN_REVIEW,
DECLINED
retention_class
enum<string>[]

الأحداث في فئات الاحتفاظ هذه فقط. كرر لعدة قيم.

الخيارات المتاحة:
low_value,
standard,
risk_relevant,
monetary_or_compliance
subject_vendor_data
string

تطابق تام في vendor_data الخاص بالموضوع. يمكن للمعرّف نفسه أن يسمي فرداً وشركة؛ أضف subject_entity_type لاختيار أحدهما، أو استخدم GET /v3/events/subjects/{vendor_data}/.

subject_entity_type
enum<string>

يعيد company أحداث كيانات الشركات فقط؛ وأي قيمة أخرى غير فارغة (على سبيل المثال individual) تعيد أحداث الأفراد فقط. احذفه لإعادة كليهما.

الخيارات المتاحة:
individual,
company
business_vendor_data
string

تطابق تام في business.vendor_data المرسل مع الحدث.

session_id
string

تطابق تام في session.session_id.

device_fingerprint
string

تطابق تام في device_context.fingerprint.

ip_address
string

تطابق تام في عنوان IP الخاص بالحدث.

game_id
string

تطابق تام في game_id المُروَّج إلى المستوى الأعلى.

round_id
string

تطابق تام مع round_id المُروَّج إلى المستوى الأعلى.

affiliate_code
string

تطابق تام مع affiliate_code المُروَّج إلى المستوى الأعلى.

payment_reference_id
string

تطابق تام في مرجع الدفع (من transaction_context.payment_reference_id أو payload.payment_reference_id).

counterparty_vendor_data
string

تطابق تام في counterparty_vendor_data المُروَّج إلى المستوى الأعلى.

matched_only
boolean
افتراضي:false

تُرجع القيمة true (وكذلك 1 أو yes، بدون تحسس لحالة الأحرف) الأحداث التي طابقت قاعدة واحدة على الأقل فقط (rules_matched_count أكبر من 0). وتُتجاهل أي قيمة أخرى.

occurred_from
string<date-time>

فقط الأحداث التي يكون فيها occurred_at في هذه اللحظة أو بعدها (شاملًا). أرسل قيمة بتنسيق ISO 8601: مثل 2026-10-01T00:00:00Z، أو إزاحة صريحة مع ترميز + بنسبة مئوية (2026-10-01T02:00:00%2B02:00؛ حيث يتم فك ترميز + غير المرمز كمسافة وتتعذر قراءة القيمة)، أو تاريخ بمفرده (2026-10-01)، وهو ما يعني 00:00:00 UTC من ذلك اليوم. تُقرأ القيمة بدون إزاحة على أنها بتوقيت UTC. لا تُقبل القيم بأي تنسيق آخر.

occurred_to
string<date-time>

فقط الأحداث التي يكون فيها occurred_at في هذه اللحظة أو قبلها (شاملًا). التاريخ بمفرده يعني بداية ذلك اليوم، لذا فإن occurred_to=2026-10-15 يستبعد بقية يوم 15 أكتوبر؛ أرسل 2026-10-15T23:59:59Z لتضمينه. أرسل قيمة بتنسيق ISO 8601: مثل 2026-10-01T00:00:00Z، أو إزاحة صريحة مع ترميز + بنسبة مئوية (2026-10-01T02:00:00%2B02:00؛ حيث يتم فك ترميز + غير المرمز كمسافة وتتعذر قراءة القيمة)، أو تاريخ بمفرده (2026-10-01)، وهو ما يعني 00:00:00 UTC من ذلك اليوم. تُقرأ القيمة بدون إزاحة على أنها بتوقيت UTC. لا تُقبل القيم بأي تنسيق آخر.

تطابق لسلسلة فرعية غير حساس لحالة الأحرف في event_id أو action_type أو subject_vendor_data أو counterparty_vendor_data.

الاستجابة

صفحة واحدة من ملخصات الأحداث.

صفحة واحدة من أحداث المراقبة، الأحدث في occurred_at أولاً.

count
integer
مطلوب

عدد الأحداث المتطابقة، دقيق حتى 100 ويقتصر على 100 كحد أقصى بعد ذلك. لا تحسب عدد الصفحات بناءً عليه؛ اتبع next حتى تصبح null.

next
string<uri> | null
مطلوب

رابط URL للصفحة التالية، أو null في الصفحة الأخيرة.

previous
string<uri> | null
مطلوب

رابط URL للصفحة السابقة، أو null في الصفحة الأولى.

results
object[]
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦