الانتقال إلى المحتوى الرئيسي
POST
curl
أضِف إلى قائمة الحظر ما جمعته جلسة تحقق واحدة: الوجه، ومستند الهوية، ورقم الهاتف، أو عنوان البريد الإلكتروني. يضع Didit علامة “محظور” على كل سجل محدد، ويضيفه إلى قائمة الحظر المقابلة في النظام، مرتبطًا بالجلسة. بعد ذلك، تُرفض الجلسات الجديدة التي تتطابق وجوهها أو أرقام مستنداتها أو أرقام هواتفها أو عناوين بريدها الإلكتروني.
العملية إما أن تنجح كاملةً أو لا تُنفَّذ أيًا منها: إذا لم تتضمن الجلسة سجلًا من النوع المحدد، أو إذا كان المستند يفتقر إلى دولة الإصدار أو نوع المستند أو رقم المستند أو الاسم الكامل، تُرجع العملية 400 ولا يُضاف أي عنصر إلى قائمة الحظر. إعادة الاستدعاء لعنصر مُضاف مسبقًا إلى قائمة الحظر آمنة.
لمراجعة العناصر المحظورة، استخدم قائمة العناصر المحظورة. لرفع الحظر، استخدم إزالة من قائمة الحظر. لحظر عنوان IP أو بصمة جهاز أو مستخدم أو شركة أو قيمة غير مرتبطة بجلسة، أضِف إدخالًا إلى قائمة الحظر المقابلة في النظام باستخدام إنشاء إدخال. راجع قائمة الحظر الخاصة بالمستخدم لمعرفة كيفية تطبيق قوائم الحظر.

التفويضات

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

يجب أن تكون علامة blocklist_* واحدة على الأقل مضبوطة على true.

session_id
string<uuid>
مطلوب

جلسة تحقق من شخص تابعة لتطبيقك. يتم رفض الجلسات المحذوفة.

blocklist_face
boolean
افتراضي:false

إضافة وجه الجلسة إلى قائمة الحظر.

blocklist_document
boolean
افتراضي:false

إضافة مستند الهوية للجلسة إلى قائمة الحظر. يتطلب المستند دولة إصداره ونوعه ورقمه والاسم الكامل.

blocklist_phone
boolean
افتراضي:false

إضافة رقم هاتف الجلسة إلى قائمة الحظر.

blocklist_email
boolean
افتراضي:false

إضافة البريد الإلكتروني للجلسة إلى قائمة الحظر.

الاستجابة

تمت إضافة العناصر المحددة إلى قائمة الحظر.

message
string
مطلوب

دائماً Successfully updated blocklist.

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