الانتقال إلى المحتوى الرئيسي
تتيح واجهة Bank data API من Didit ربط حساب بنك الشخص عبر Bank Link، والحفاظ على هذا الاتصال طالما يسمح الشخص بذلك، وتقديم حساباته وأرصدته ومعاملاته. عنوان URL الأساسي هو https://verification.didit.me/v3/، وتتم المصادقة باستخدام مفتاح API لتطبيقك في الترويسة x-api-key، كما في جميع واجهات البرمجة المستقلة. تقبل كل عملية كتابة Idempotency-Key. تقبل القوائم المعامل limit (القيمة الافتراضية 100، والحد الأقصى 500) وتتابع النتائج عبر cursor، باستثناء قراءات المعاملات: تتابع قراءة نطاق التواريخ عبر page_token، أما خلاصة التغييرات فتقبل مؤشراً دائماً عبر cursor، وتتابع الصفحة عبر page_token. لا تُحتسب رسوم على عمليات القراءة إطلاقاً. تتضمن الأخطاء الحقول code وmessage وrequest_id وfield وnext_action وretry_after: ينبغي أن تبني منطق المعالجة على code. تتطلب كل عملية، باستثناء فحص الحساب، مفتاح API يحمل الإذن Bank data، ولا يتضمن الوصول الكامل هذا الإذن. لا يستخدم فحص الحساب هذا الإذن، بل يتطلب مفتاح API بصلاحية الكتابة إلى الجلسات، أو الوصول الكامل. بيانات البنوك متاحة للتطبيقات في البيئة التجريبية (sandbox). تُرجع استدعاءات تطبيق الإنتاج الرمز 404 إلى أن يُعلَن عن إتاحة الوصول إلى بيئة الإنتاج، ولا تُحتسب أي رسوم في البيئة التجريبية.

الروابط

إنشاء رابط

POST /v3/bank/links/

الحصول على رابط

GET /v3/bank/links/{id}/

إلغاء رابط

POST /v3/bank/links/{id}/cancel/

الاتصالات

عرض قائمة الاتصالات

GET /v3/bank/connections/

الحصول على اتصال

GET /v3/bank/connections/{id}/

تحديث

POST /v3/bank/connections/{id}/refresh/

تجديد

POST /v3/bank/connections/{id}/renew/

إبطال

POST /v3/bank/connections/{id}/revoke/

حذف

DELETE /v3/bank/connections/{id}/

عمليات المزامنة

GET /v3/bank/connections/{id}/sync-runs/

الحصول على عملية مزامنة

GET /v3/bank/connections/{id}/sync-runs/{sync_id}/

الحسابات والأرصدة والمعاملات

سرد الحسابات

GET /v3/bank/connections/{id}/accounts/

الحصول على حساب

GET /v3/bank/accounts/{account_id}/

الحصول على الأرصدة

GET /v3/bank/accounts/{account_id}/balances/

سرد المعاملات

GET /v3/bank/accounts/{account_id}/transactions/

موجز تغييرات المعاملات

GET /v3/bank/connections/{id}/transactions/sync/

البنوك والتغطية

قائمة المؤسسات

GET /v3/bank/institutions/

الحصول على مؤسسة

GET /v3/bank/institutions/{id}/

الحصول على التغطية

GET /v3/bank/coverage/

التحقق من الحساب

POST /v3/bank/account-check/

الأدلة

حزم SDK للخادم

توفّر حزم SDK الخادمية السبع هذه العمليات ضمن المورد bank، وتُسمّى كل عملية باسمها، مثل create_link وget_connection وsync_transactions وغيرها.
آخر تعديل في ٢٢ نوفمبر ٢٠٢٦