الانتقال إلى المحتوى الرئيسي
تتوفّر بيانات البنك للتطبيقات في البيئة التجريبية. تُرجع استدعاءات تطبيق الإنتاج الرمز 404 إلى أن يُعلَن عن إتاحة الوصول إلى بيئة الإنتاج، ولا تُحتسب أي رسوم في البيئة التجريبية. يأخذك هذا الدليل السريع من تطبيق في البيئة التجريبية إلى الحسابات والأرصدة والمعاملات الخاصة بـ Didit Test Bank، عبر طلبات جاهزة للنسخ واللصق.
كل استجابة معروضة أدناه مقتصرة على الحقول المهمة. احتفظ بمفتاح API على خادمك، فهو لا يصل إلى المتصفح أو التطبيق أبدًا.

الخطوة 1: إنشاء مفتاح API بصلاحية Bank data

لا تُعدّ صلاحية Bank data جزءاً من الوصول الكامل. يُرفض المفتاح ذو الوصول الكامل، بما فيه السر الأساسي للتطبيق، في كل استدعاء لـ Bank data مع الخطأ 403 bank_data_access_denied.
  1. في Business Console، افتح تطبيق البيئة التجريبية الخاص بك وانتقل إلى API keys.
  2. أنشئ مفتاحاً بوصول مخصص وأضف Bank data: Read للقراءات، وWrite للاستدعاءات التي تنشئ شيئاً أو تعدّله أو تحذفه.
  3. انسخ المفتاح وصدّره:
راجع مفاتيح API للاطلاع على القائمة الكاملة للموارد.

الخطوة 2: إنشاء رابط

الرابط هو تشغيل واحد لمجموعة الشاشات يتصل فيها الشخص ببنك. أنشئ رابطًا مستمرًا لـ Test Bank:
country هو رمز الدولة المكوّن من ثلاثة أحرف للبنك الذي يتعامل معه الشخص، وهو اختياري. أرسله عندما تعرفه، فيرى الشخص بنوك تلك الدولة فقط. وإن لم ترسله، يختار الشخص من بين كل الدول التي يمكنك تقديم الخدمة لها. للوصول لمرة واحدة، أرسل "access": "one_time" (وهي القيمة الافتراضية).
اربط المعرّف id الخاص بالرابط بالمستخدم لديك. تُعاد url وclient_token مرة واحدة فقط، عند إنشاء الرابط.

الخطوة 3: افتح الرابط واربط Didit Test Bank

افتح url في المتصفح، أو أرسله إلى الشخص عبر البريد الإلكتروني أو الدردشة. يرى الشخص شاشة الموافقة، ويختار Didit Test Bank، ويسجّل الدخول بأحد العملاء التجريبيين، ثم يختار الحسابات التي يريد مشاركتها. تسرد صفحة البيئة التجريبية العملاء التجريبيين، وما يمنحك إياه كل منهم. لإعادة الشخص إلى موقعك بعد ذلك، راجع العودة إلى موقعك. إذا لم تُحدِّد redirect_url، ينتهي الشخص على صفحة نتيجة Didit، وتعرف النتيجة من webhook أو من قراءة البيانات.

الخطوة 4: استقبال الـ webhooks والتأكيد

اشترك بوجهة webhook في أحداث bank.* من وحدة التحكم، كما هو الحال مع أي webhook. عندما ينتهي المستخدم، يصل الحدث bank.link.completed مع link_id وconnection_id، ثم يصل الحدث bank.connection.created بعد أن تُخزّن أول مزامنة الحسابات. لا تثق أبدًا بمعرّف رابط يرسله لك المتصفح. اقرأ الرابط بنفسك:
تكون قيمة status إما completed أو قيمة نهائية أخرى (cancelled أو expired أو failed). الرابط الذي تكون حالته failed يحمل error.code، أما الرابط الذي تكون حالته cancelled فيكون error: null.

الخطوة 5: قراءة الحسابات والأرصدة والمعاملات

المبالغ سلاسل نصية عشرية، وتكون سالبة للأموال الخارجة. تتضمن صفحة المعاملات الحقل next_page_token طالما بقي المزيد لقراءته. راجع الحسابات والأرصدة والمعاملات.

الخطوة 6: متابعة خلاصة التغييرات

تُعيد خلاصة التغييرات ما تغيّر فقط منذ قراءتك الأخيرة. قراءتك الأولى، دون مؤشر، هي اللقطة الكاملة: كل معاملات الاتصال، وكل معاملة منها بالحالة added مع reset: true. قد تتضمن الصفحة الأولى has_more: true مع next_page_token، دون وجود next_cursor بعد. واصل القراءة باستخدام page_token ما دامت قيمة has_more هي true، واحفظ next_cursor الخاص بالصفحة الأخيرة (تلك التي يكون فيها has_more: false) للمرة القادمة:
تعني reset: true أن الاستجابة لقطة كاملة، فاستبدل نسختك بها بدلًا من إضافتها إليها. يُعلمك الحدث bank.data.updated متى خزّنت مزامنةٌ بيانات جديدة.

الخطوة 7: المزامنة الآن

تتم مزامنة الاتصال المستمر تلقائياً. لقراءة بيانات البنك الآن، اطلب مزامنة:
يسمح البنك بعدد محدود من القراءات غير المراقبة في اليوم. يُبيّن الحقلان sync.live_syncs_left_today وsync.budgets في الاتصال عدد القراءات المتبقية وموعد إعادة ضبطها، ويرد الاستدعاء الذي يتجاوز الحد بالرمز 429 refresh_limit_reached مع وقت إعادة الضبط. راجع تحديث بيانات البنك عند الطلب.

الخطوة 8: إيقاف الوصول والحذف

إيقاف الوصول والحذف استدعاءان منفصلان.
لا تحتوي استجابة الاتصال المحذوف إلا على الحقول id وstatus وstatus_reason وcreated_at وerasure. راجع البيانات والموافقة والحذف.

Next steps

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