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

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

  • تُنفَّذ أول مزامنة عند اتصال الشخص.
  • بعد ذلك، يتم تزامن كل اتصال مستمر نشط تلقائياً بين مرة واحدة وأربع مرات يومياً، حسب البنك. يوضح sync.frequency_per_day على الاتصال عدد هذه المزامنات، ويوضح sync.next_sync_at موعد المزامنة التالية.
  • عندما يسمح البنك بعدد أكبر من القراءات التلقائية في اليوم، يبقى دائماً مرتان يومياً على الأقل متاحتين لعمليات المزامنة الفورية.
  • عندما تُخزَّن تغييرات بعد المزامنة، يصل الحدث bank.data.updated، فتقرأ موجز التغييرات باستخدام المؤشر الخاص بك.
  • تُعاد محاولة المزامنة الفاشلة باستخدام التراجع التدريجي. بعد 24 ساعة من الفشل، يبقى الاتصال في الحالة active مع sync.status: failing، ويُرسَل الحدث bank.sync.failed. يُرسَل بعد ذلك الحدث bank.sync.recovered عندما تعمل المزامنة من جديد.
  • عندما يطلب البنك من الشخص تسجيل الدخول مرة أخرى، تنتقل حالة الاتصال إلى renewal_required.

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

أضِف "wait": true وسيعيد طلب واحد بيانات محدّثة:
الرأس Prefer: wait=25 يؤدي الغرض نفسه. ينتظر الطلب ما يصل إلى 25 ثانية:
إذا كانت هناك مزامنة قيد التشغيل بالفعل، ستحصل على sync_id نفسه، لا على مهمة ثانية. بعد استجابة 200 أو bank.data.updated، اقرأ تغذية التغييرات باستخدام المؤشر المخزّن لديك. لقراءة ما فعلته مزامنة لاحقًا، استخدم get_sync_run.

السعر

تُدرج كلٌّ من المزامنات التلقائية والمزامنات المباشرة ضمن السعر الشهري للاتصال، راجع الأسعار. لا تُضيف المزامنة المباشرة أي رسوم أبداً.

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

يحدّ البنك من عدد مرات جلب البيانات في غياب الشخص. تسمح القواعد الأوروبية للبنك بتقييد الوصول دون حضور المستخدم بأربع عمليات قراءة يوميًا لكل حساب. وهذا سقف وليس وعدًا: قد يسمح البنك بعدد أقل، أو يوافق على عدد أكبر.
  • تتشارك المزامنة التلقائية والمزامنة الفورية الميزانية نفسها، ولا تستخدم الجدولة التلقائية أبدًا آخر عمليتي قراءة في اليوم.
  • يوضح 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.

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

ذات صلة

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