> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# مرجع بيانات البنوك API: الربط والاتصالات والحسابات والمعاملات

> نقاط نهاية بيانات البنوك في Didit: إنشاء رابط بنك، وإدارة الاتصالات، وقراءة الحسابات والأرصدة والمعاملات، ومتابعة التغييرات.

تتيح واجهة 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، ولا يتضمن الوصول الكامل هذا الإذن.
لا يستخدم [فحص الحساب](https://docs.didit.me/ar/standalone-apis/bank-account-check.md) هذا الإذن، بل يتطلب مفتاح API بصلاحية الكتابة إلى الجلسات، أو الوصول الكامل.
بيانات البنوك متاحة للتطبيقات في البيئة التجريبية (sandbox). تُرجع استدعاءات تطبيق الإنتاج الرمز `404` إلى أن يُعلَن عن إتاحة الوصول إلى بيئة الإنتاج، ولا تُحتسب أي رسوم في البيئة التجريبية.

## الروابط

> [card] [إنشاء رابط](https://docs.didit.me/ar/standalone-apis/bank-link-create.md)
>
> `POST /v3/bank/links/`

> [card] [الحصول على رابط](https://docs.didit.me/ar/standalone-apis/bank-link-get.md)
>
> `GET /v3/bank/links/{id}/`

> [card] [إلغاء رابط](https://docs.didit.me/ar/standalone-apis/bank-link-cancel.md)
>
> `POST /v3/bank/links/{id}/cancel/`

## الاتصالات

> [card] [عرض قائمة الاتصالات](https://docs.didit.me/ar/standalone-apis/bank-connections-list.md)
>
> `GET /v3/bank/connections/`

> [card] [الحصول على اتصال](https://docs.didit.me/ar/standalone-apis/bank-connection-get.md)
>
> `GET /v3/bank/connections/{id}/`

> [card] [تحديث](https://docs.didit.me/ar/standalone-apis/bank-connection-refresh.md)
>
> `POST /v3/bank/connections/{id}/refresh/`

> [card] [تجديد](https://docs.didit.me/ar/standalone-apis/bank-connection-renew.md)
>
> `POST /v3/bank/connections/{id}/renew/`

> [card] [إبطال](https://docs.didit.me/ar/standalone-apis/bank-connection-revoke.md)
>
> `POST /v3/bank/connections/{id}/revoke/`

> [card] [حذف](https://docs.didit.me/ar/standalone-apis/bank-connection-delete.md)
>
> `DELETE /v3/bank/connections/{id}/`

> [card] [عمليات المزامنة](https://docs.didit.me/ar/standalone-apis/bank-sync-runs-list.md)
>
> `GET /v3/bank/connections/{id}/sync-runs/`

> [card] [الحصول على عملية مزامنة](https://docs.didit.me/ar/standalone-apis/bank-sync-run-get.md)
>
> `GET /v3/bank/connections/{id}/sync-runs/{sync_id}/`

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

> [card] [سرد الحسابات](https://docs.didit.me/ar/standalone-apis/bank-accounts-list.md)
>
> `GET /v3/bank/connections/{id}/accounts/`

> [card] [الحصول على حساب](https://docs.didit.me/ar/standalone-apis/bank-account-get.md)
>
> `GET /v3/bank/accounts/{account_id}/`

> [card] [الحصول على الأرصدة](https://docs.didit.me/ar/standalone-apis/bank-account-balances.md)
>
> `GET /v3/bank/accounts/{account_id}/balances/`

> [card] [سرد المعاملات](https://docs.didit.me/ar/standalone-apis/bank-account-transactions.md)
>
> `GET /v3/bank/accounts/{account_id}/transactions/`

> [card] [موجز تغييرات المعاملات](https://docs.didit.me/ar/standalone-apis/bank-transactions-sync.md)
>
> `GET /v3/bank/connections/{id}/transactions/sync/`

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

> [card] [قائمة المؤسسات](https://docs.didit.me/ar/standalone-apis/bank-institutions-list.md)
>
> `GET /v3/bank/institutions/`

> [card] [الحصول على مؤسسة](https://docs.didit.me/ar/standalone-apis/bank-institution-get.md)
>
> `GET /v3/bank/institutions/{id}/`

> [card] [الحصول على التغطية](https://docs.didit.me/ar/standalone-apis/bank-coverage.md)
>
> `GET /v3/bank/coverage/`

> [card] [التحقق من الحساب](https://docs.didit.me/ar/standalone-apis/bank-account-check.md)
>
> `POST /v3/bank/account-check/`

## الأدلة

* [البدء السريع لبيانات البنوك](https://docs.didit.me/ar/core-technology/bank-verification/quickstart.md)
* [الاتصالات](https://docs.didit.me/ar/core-technology/bank-verification/connections.md)
* [الحسابات والأرصدة والمعاملات](https://docs.didit.me/ar/core-technology/bank-verification/accounts-balances-transactions.md)
* [webhooks الخاصة بالبنوك](https://docs.didit.me/ar/core-technology/bank-verification/webhooks.md)
* [البيئة التجريبية](https://docs.didit.me/ar/core-technology/bank-verification/sandbox.md)
* [الأسعار](https://docs.didit.me/ar/getting-started/bank-verification-pricing.md)

## حزم SDK للخادم

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.