الانتقال إلى المحتوى الرئيسي
GET
curl
تُعيد نقطة endpoint ‏List Bank Connections الخاصة بـ Didit اتصالات البنوك الخاصة بك، مُصفّاةً حسب الحالة والوصول والبنك والدولة والمراجع الخاصة بك وتاريخ انتهاء الموافقة. استخدم consent_expires_before للعثور على الموافقات التي تحتاج إلى تجديد، وend_user_reference للعثور على اتصالات عميل بعينه. تُقسَّم القائمة إلى صفحات باستخدام cursor.

التفويضات

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.

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

status
enum<string>

الاتصالات بهذه الحالة فقط.

الخيارات المتاحة:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

وضع الوصول هذا فقط.

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

هذا البنك فقط.

Maximum string length: 64
country
string

البنوك في هذه الدولة فقط.

Pattern: ^[A-Z]{3}$
vendor_data
string

الاتصالات التي تحمل vendor_data هذا فقط.

Maximum string length: 255
end_user_reference
string

الاتصالات التي تحمل end_user.reference هذا فقط.

Maximum string length: 255

الاتصالات التي تنتهي موافقتها قبل هذا الوقت فقط، مثلا لإرسال روابط التجديد.

created_after
string<date-time>

الاتصالات التي أُنشئت بعد هذا الوقت فقط.

limit
integer
افتراضي:100

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

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

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

الاستجابة

صفحة من الاتصالات.

صفحة من الاتصالات.

items
object[]
مطلوب
next_cursor
string | null
مطلوب

أرسله كقيمة cursor للصفحة التالية. يكون null في الصفحة الأخيرة.

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