الانتقال إلى المحتوى الرئيسي
GET
curl
تُعيد endpoint List Institutions من Didit قائمة البنوك حسب الدولة، مع بيان ما تدعمه كل منها: الشرائح، والوصول المستمر، ومدة الموافقة، وعمق السجل، والحقول التي تُرسلها. صفِّ النتائج حسب country وsegment وaccess وq. راجع تغطية البنوك.

التفويضات

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

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

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

country
string

البنوك في هذه الدولة فقط، بصيغة رمز ISO 3166-1 alpha-3. إذا كانت الدولة لا تخدمها Bank Link، تُرجع 400 invalid_request مع field: country.

Pattern: ^[A-Z]{3}$
segment
enum<string>

البنوك التي تخدم هذه الفئة فقط.

الخيارات المتاحة:
personal,
business
access
enum<string>

البنوك التي تقدم وضع الوصول هذا فقط.

الخيارات المتاحة:
one_time,
ongoing
q
string

البحث بالاسم أو المعرّف، دون تمييز بين الأحرف الكبيرة والصغيرة.

Maximum string length: 100
limit
integer
افتراضي:100

حجم الصفحة، من 1 إلى 500. القيمة الافتراضية 100.

النطاق المطلوب: 1 <= x <= 500
cursor
string

مؤشر مبهم من next_cursor في الصفحة السابقة.

الاستجابة

صفحة من البنوك.

items
object[]
مطلوب
next_cursor
string | null
مطلوب
آخر تعديل في ٢٢ نوفمبر ٢٠٢٦