> ## 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.

# مزامنة الآن: تحديث بيانات البنك عند الطلب

> اطلب أحدث بيانات البنك لأي اتصال في أي وقت باستدعاء واحد، وانتظر النتيجة، واعرف الحد اليومي للبنك وما تعيده الاستجابة 429 في Didit.

يقرأ Sync Now أحدث بيانات الاتصال من البنك في أي لحظة، عبر طلب واحد فقط.
تُدرج المزامنات الفورية ضمن السعر الشهري للاتصال، ولا يُفرض عليها أي رسوم إضافية.
الحد الوحيد هو الحد الذي يفرضه البنك.

## التزامن التلقائي

* تُنفَّذ أول مزامنة عند اتصال الشخص.
* بعد ذلك، يتم تزامن كل اتصال مستمر نشط تلقائياً بين مرة واحدة وأربع مرات يومياً، حسب البنك. يوضح `sync.frequency_per_day` على الاتصال عدد هذه المزامنات، ويوضح `sync.next_sync_at` موعد المزامنة التالية.
* عندما يسمح البنك بعدد أكبر من القراءات التلقائية في اليوم، يبقى دائماً مرتان يومياً على الأقل متاحتين لعمليات المزامنة الفورية.
* عندما تُخزَّن تغييرات بعد المزامنة، يصل الحدث `bank.data.updated`، فتقرأ [موجز التغييرات](https://docs.didit.me/ar/standalone-apis/bank-transactions-sync.md) باستخدام المؤشر الخاص بك.
* تُعاد محاولة المزامنة الفاشلة باستخدام التراجع التدريجي. بعد 24 ساعة من الفشل، يبقى الاتصال في الحالة `active` مع `sync.status: failing`، ويُرسَل الحدث `bank.sync.failed`. يُرسَل بعد ذلك الحدث `bank.sync.recovered` عندما تعمل المزامنة من جديد.
* عندما يطلب البنك من الشخص تسجيل الدخول مرة أخرى، تنتقل حالة الاتصال إلى `renewal_required`.

## المزامنة الآن، بطلب واحد

أضِف `"wait": true` وسيعيد طلب واحد بيانات محدّثة:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "wait": true }'
```

الرأس `Prefer: wait=25` يؤدي الغرض نفسه.
ينتظر الطلب ما يصل إلى 25 ثانية:

| الإجابة | المعنى |
| - | - |
| `200` | اكتملت المزامنة. يتضمن النص المزامنة مع `outcome`، وأعداد `added` و`modified` و`removed` لكل حساب، و`balances_changed`. |
| `202` | لم يرد البنك خلال 25 ثانية، أو لم تطلب الانتظار. يتضمن النص `sync_id`: اقرأ المزامنة باستخدام `get_sync_run`، أو اشترك في `bank.sync.completed`. يُرسَل `bank.data.updated` فقط إذا خزّنت المزامنة تغييرات. |

```json theme={null}
{
  "id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
  "trigger": "requested",
  "status": "succeeded",
  "outcome": "succeeded",
  "balances_changed": true,
  "results": [{ "resource": "transactions", "outcome": "succeeded", "added": 3, "modified": 0, "removed": 1 }]
}
```

إذا كانت هناك مزامنة قيد التشغيل بالفعل، ستحصل على `sync_id` نفسه، لا على مهمة ثانية.
بعد استجابة `200` أو `bank.data.updated`، اقرأ تغذية التغييرات باستخدام المؤشر المخزّن لديك.
لقراءة ما فعلته مزامنة لاحقًا، استخدم [`get_sync_run`](https://docs.didit.me/ar/standalone-apis/bank-sync-run-get).

## السعر

تُدرج كلٌّ من المزامنات التلقائية والمزامنات المباشرة ضمن السعر الشهري للاتصال، راجع [الأسعار](https://docs.didit.me/ar/getting-started/bank-verification-pricing.md).
لا تُضيف المزامنة المباشرة أي رسوم أبداً.

## حد البنك اليومي

يحدّ البنك من عدد مرات جلب البيانات في غياب الشخص.
تسمح القواعد الأوروبية للبنك بتقييد الوصول دون حضور المستخدم بأربع عمليات قراءة يوميًا لكل حساب.
وهذا سقف وليس وعدًا: قد يسمح البنك بعدد أقل، أو يوافق على عدد أكبر.

* تتشارك المزامنة التلقائية والمزامنة الفورية الميزانية نفسها، ولا تستخدم الجدولة التلقائية أبدًا آخر عمليتي قراءة في اليوم.
* يوضح `sync.live_syncs_left_today` في الاتصال عدد المزامنات الفورية المتبقية لهذا اليوم، ويعرض `sync.budgets[]` كل حصة: `scope` (`connection` أو `account`)، و`resource`، و`limit`، و`remaining`، و`resets_at`.
* أثناء وجود الشخص في Bank Link، لأجل التجديد أو إعادة الاتصال، لا تكون عمليات القراءة محدودة.
* عند استنفاد ميزانية اليوم، يعيد الاستدعاء `429 refresh_limit_reached` مع ترويسة `Retry-After` (عدد الثواني حتى تُعاد تعيين الميزانية) وكائن `sync` يحتوي على `live_syncs_left_today` و`budgets`. انتظر هذه المدة، واعتمد على المزامنة التلقائية في الأثناء.
* حدود واجهة API الخاصة بك منفصلة عن ذلك: 600 عملية قراءة و300 عملية كتابة في الدقيقة لكل تطبيق، مع ترويسات `X-RateLimit-*`.

## معرفة مدى حداثة البيانات

* `sync.last_synced_at` على الاتصال وعلى كل حساب هو الوقت الذي جلب فيه Didit البيانات من البنك آخر مرة، وليس الوقت الذي قرأتها فيه أنت آخر مرة.
* يُرجِع كلا طلبي قراءة المعاملات الرأس `X-Bank-Last-Synced-At`.

## الأخطاء التي يجب عليك معالجتها

| الخطأ | المعنى | الإجراء |
| - | - | - |
| `429 refresh_limit_reached` | استُنفدت ميزانية البنك. | انتظر `Retry-After`، واعتمد على المزامنة التلقائية. |
| `409 connection_not_active` | الاتصال ليس `active`. | تحقق من حالته. |
| `409 consent_expired` | انتهت صلاحية الموافقة. | [جدّدها](https://docs.didit.me/ar/use-cases/renew-bank-consent.md). |

## ذات صلة

* [تغذية بيانات بنكية مستمرة للمحاسبة](https://docs.didit.me/ar/use-cases/bank-data-for-accounting.md)
* [webhooks الخاصة بالبنوك](https://docs.didit.me/ar/core-technology/bank-verification/webhooks.md)


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