الانتقال إلى المحتوى الرئيسي
GET
curl
استرجع قائمة مقسّمة إلى صفحات تضم كل قائمة نشطة في تطبيقك: القوائم النظامية التي يوفّرها Didit (قائمة حظر واحدة لكل نوع إدخال، وقائمة High Risk Countries، وأي قائمة سماح نظامية)، وقوائم السماح والقوائم المخصصة التي أنشأتها. صفِّ النتائج حسب list_type أو entry_type، واقرأ قيم القائمة من خلال إدخالات القائمة. راجع القوائم لمعرفة وظيفة كل نوع من القوائم أثناء التحقق وفحص المعاملات.

التفويضات

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.

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

list_type
enum<string>

القوائم من هذا النوع فقط.

الخيارات المتاحة:
blocklist,
allowlist,
custom
entry_type
enum<string>

القوائم من نوع الإدخال هذا فقط.

الخيارات المتاحة:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
ordering
enum<string>
افتراضي:-created_at

ترتيب الفرز: -created_at (الأحدث أولاً، وهو الافتراضي) أو created_at (الأقدم أولاً).

الخيارات المتاحة:
-created_at,
created_at
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[]
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦