الانتقال إلى المحتوى الرئيسي
GET
curl
اعرض الوجوه ووثائق الهوية وأرقام الهواتف وعناوين البريد الإلكتروني الموجودة في جلسات التحقق الخاصة بك والمدرجة حاليًا في قائمة الحظر، مرتبة من الأحدث إلى الأقدم. يشير كل عنصر إلى الجلسة التي جاء منها، حتى تتمكن من فتحها في وحدة التحكم أو جلب قرارها. تعرض هذه الخلاصة ما أُضيف إلى قائمة الحظر من جلسة: باستخدام إضافة إلى قائمة الحظر من وحدة التحكم، أو عبر إدخال في القائمة أُنشئ من reference_session_id. أما القيم المُدخلة يدويًا في قائمة، والوجوه المرفوعة، والوجوه المأخوذة من صورة السيلفي الملتقطة مع المستند، وأنواع الإدخال الأخرى (عنوان 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.

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

item_type
enum<string>

العناصر من هذا النوع فقط. عند حذفه، يتم إرجاع كل نوع.

الخيارات المتاحة:
face,
document,
phone,
email
limit
integer
افتراضي:50

حجم الصفحة. القيمة الافتراضية 50. القيمة الأعلى من 1000000 تُرجع 400؛ والقيمة الصفرية أو السالبة أو غير الرقمية ترجع إلى 50.

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

فهرس يستند إلى الصفر للعنصر الأول المراد إرجاعه. يُفضل اتباع next. القيمة التي تزيد عن 1000000 تُرجع 400؛ والقيمة السالبة أو غير الرقمية ترجع تلقائياً إلى 0.

النطاق المطلوب: 0 <= x <= 1000000

الاستجابة

صفحة من العناصر المدرجة في قائمة الحظر، الأحدث أولاً.

count
integer
مطلوب

العدد الإجمالي للعناصر الموجودة في قائمة الحظر المطابقة للمرشحات.

النطاق المطلوب: x >= 0
next
string<uri> | null
مطلوب

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

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

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

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