الانتقال إلى المحتوى الرئيسي
POST
curl
يستهلك مسار الأجهزة بيانات الاعتماد هذه، كما هو موضح في إرسال أحداث SDK. كما يسرد أيضًا ما يفرضه الخادم على كل طلب من الجهاز، والأحداث التي يمكن إسقاطها بأمان عند الضغط العكسي.

التفويضات

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.

الجسم

application/json

تُقبل أسماء camelCase البديلة: vendorData وentityType وallowedEventCategories وttlSeconds وmaxUses وbindToOrigin.

vendor_data
string
مطلوب

المعرّف الخاص بك للكيان الذي ينتمي إليه كل حدث يتم إرساله باستخدام بيانات الاعتماد هذه.

Required string length: 1 - 255
entity_type
string
افتراضي:individual

يربط company الموضوع بكيان شركة؛ وأي قيمة أخرى (الافتراضية individual) تربطه بفرد.

Maximum string length: 32
allowed_event_categories
enum<string>[]

الفئات التي يجوز لبيانات الاعتماد إرسالها. احذفها أو أرسل [] للسماح بجميع الفئات.

الخيارات المتاحة:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
افتراضي:900

عمر صلاحية بيانات الاعتماد بالثواني.

النطاق المطلوب: 60 <= x <= 86400
max_uses
integer | null
افتراضي:1000

عدد الأحداث التي يجوز لبيانات الاعتماد إرسالها (تستهلك الدفعة استخداماً واحداً لكل حدث). أرسل null لعدم تحديد حد أقصى طوال فترة الصلاحية.

النطاق المطلوب: x >= 1
bind_to_origin
string | null

عند تعيينه، يجب أن يتطابق رأس Origin للمتصفح لكل طلب جهاز مع هذه القيمة تماماً؛ ويتم رفض أي طلب بدون رأس Origin.

Maximum string length: 255

الاستجابة

تم إصدار بيانات الاعتماد. مرّر monitoring_token إلى التطبيق وعامله كسرّ حتى expires_at.

monitoring_token
string
مطلوب

بيانات اعتماد الجهاز (token آمن لعناوين URL مكوّن من 43 حرفاً). أرسله في الرأس X-Monitoring-Token.

expires_at
string<date-time>
مطلوب

وقت التوقف عن قبول بيانات الاعتماد.

allowed_event_categories
enum<string>[]
مطلوب

الفئات التي يجوز لبيانات الاعتماد إرسالها؛ وتعني [] جميع الفئات.

الخيارات المتاحة:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
مطلوب

ميزانية الأحداث لبيانات الاعتماد؛ تعني قيمة null عدم وجود حد أقصى.

bind_to_origin
string | null
مطلوب

الأصل الذي ترتبط به بيانات الاعتماد، أو null.

آخر تعديل في ٧ نوفمبر ٢٠٢٦