كيفية اختبار واستكشاف أخطاء التكامل مع Toden
Charles Archibong, المؤسس المشارك
اختبر التكامل الكامل، بما في ذلك حالات الفشل والتعافي. اختر أداة الاختبار المدعومة لمجموعة واجهات برمجة التطبيقات التي تستخدمها، ثم افحص سجل Toden وسلوك تطبيقك.
أهم النقاط
- تصل جميع فروع القرار إلى مسار التطبيق المقصود.
- لا تؤدي الردود المفقودة والأحداث المتكررة إلى أي تأثير مكرر.
- يظل كل من "قيد الانتظار" و"غير متاح" منفصلين.
- تبقى التجهيزات مُصنّفة بوضوح.
- تتطلب المطالبات المتعلقة بالإنتاج فقط أدلة حية.
اختبر التكامل الكامل، بما في ذلك حالات الفشل والتعافي. اختر الجهاز المدعوم لـ API العائلة التي تستخدمها، ثم افحص كليهما Toden سجل 's وسلوك تطبيقك.
قبل أن تبدأ
سيناريو Sandbox مدعوم أو نموذج مصنف
استخدم عائلة نقاط النهاية الصحيحة و SDK إصدار
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: مطابقة المنتج والمضيف وبيانات الاعتماد
اختر Sandbox وسجل API العائلة التي تختبرها. يستخدم التحقق من الهوية المضيف /api/kyc الموثق ومفتاح الاختبار. يستخدم نظام ذكاء المخاطر مضيف /api/v1 الخاص ببيئة الاختبار ومفتاح السر. يمتلك مركز الهوية عقد /api/identity خاص به. لا تنقل حقول الطلب بين العائلات أو تفترض أن كل طلب في بيئة الاختبار مجاني. سيناريوهات ذكاء المخاطر الصريحة غير قابلة للفوترة؛ يمكن للطلبات العادية استخدام التسعير المُكوّن.
مرجع التكامل: بيئة الاختبار
الخطوة الثانية: اختر سيناريو تحقق مدعوم
افتح دليل "البيئة التجريبية واختبار المعرفات" واختر معرفًا يناسب البلد ونوع المستند. على سبيل المثال، المعرف النيجيري BVN النتائج التي تنتهي بـ 01 تُمرر، بينما ينتج عن 04 عدم تطابق في صورة السيلفي. تتطلب النتائج التي تعتمد على المستندات فقط مُعرّفًا للمستند. استخدم السيناريو المنشور أو التجاوز المدعوم؛ حيث يرفض عقد التحقق في بيئة الاختبار أرقام الهوية الحقيقية.
مرجع التكامل: مرجع السيناريو
الخطوة 3: استخدام المحاكي لرحلات المخاطر المدعومة
افتح قسم المطورين ← المحاكي في بيئة الاختبار. اختر سيناريو مدعومًا وتحقق من أهليته. تتطلب السيناريوهات المقفلة أو التي تتطلب إعدادًا متطلباتها المسبقة المعروضة؛ لا تقم بإزالة أي بوابة لتشغيلها. تتطلب تجهيزات قواعد السفر سياسة متوافقة منشورة بشكل منفصل. يثبت تشغيل سيناريو حتمي معالجته المُتحكم بها، وليس اتصالًا مباشرًا بمزود الخدمة أو تبادلًا فعليًا بين المؤسسات.
مرجع التكامل: إعداد قاعدة السفر في بيئة الاختبار
الخطوة الرابعة: اختبار جهاز الاستقبال المُوقّع بشكل مستقل
أنشئ نقطة نهاية Sandbox webhook واستخدم Testing لمحاكاة حدث مدعوم. تحقق من التوقيع مقابل البايتات الخام واحفظ معرّفه المنطقي. اختبر إعادة الإرسال، والتوقيع غير الصالح، والتوقيع المنتهي الصلاحية، وفشل المُستقبِل. تُظهر مُعرّفات العينة المُولّدة الشكل؛ وهي غير قابلة لإعادة الاستخدام. API موارد لاستدعاء لاحق.
مرجع التكامل: تجهيزات مدفوعة بالكتالوج
الخطوة الخامسة: ممارسة عدم اليقين والترتيب
قم بمحاكاة فقدان الاستجابة بعد قبول الطلب، ثم أعد محاولة العملية نفسها باستخدام مراجعها الأصلية ومفتاح التكرار حيثما يدعم العقد ذلك. قم بتأخير أو إعادة ترتيب الإشعارات المقبولة ومطابقة الحالة الحالية. اختبر نتيجة معلقة وغير متاحة بشكل منفصل عن الرفض. افحص Toden سجل حالة تطبيقك الدائمة بحثًا عن النسخ المكررة أو تغيير الوصول غير الصحيح.
مرجع التكامل: تأكيد الترتيب
الخطوة السادسة: الاحتفاظ بسجل دقيق لجاهزية الإنتاج
سجّل السيناريوهات المختبرة، والقرار المقصود، والقرار الملاحظ، والإجراءات الخلفية، وأدلة الاسترداد. تحقق من الدعم. SDK الإصدارات، واستعادة الأذونات، والأجهزة التمثيلية. قم بإعداد سير عمل الإنتاج المنفصل، والمفاتيح، والمستلم فقط بعد استيفاء متطلبات العمل والقدرات. قم بإزالة حقول سيناريو بيئة الاختبار فقط. لا يُعدّ اختبار محلي ناجح أو نتيجة مثال دليلاً على سلوك العميل الفعلي.
مرجع التكامل: قائمة التحقق لبدء التشغيل
استفد أكثر من هذه الإمكانية
حافظ على شكل البيانات الثابتة كما هو الحال في العقود العامة حتى تتمكن مجموعة الاختبارات الخاصة بك من رصد التغييرات الميدانية والإصدارية.
اختبر القرارات النهائية المتأخرة لسير العمل الذي يعتمد على الفحص أو الأشخاص الرئيسيين أو الحضور.
بدلاً من مطالبة مقدم الطلب بإصلاح انقطاع الخدمة، يجب إعطاء حالات الفشل التشغيلي رسالة خاصة به لضمان سلامة العملاء ومسار داخلي للتعافي.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
تصل جميع فروع القرار إلى مسار التطبيق المقصود.
لا تؤدي الردود المفقودة والأحداث المتكررة إلى أي تأثير مكرر.
يظل كل من "قيد الانتظار" و"غير متاح" منفصلين.
تبقى التجهيزات مُصنّفة بوضوح.
تتطلب المطالبات المتعلقة بالإنتاج فقط أدلة حية.
استكشاف الأخطاء وإصلاحها
تم رفض هويتي الحقيقية في بيئة الاختبار
استخدم معرّف اختبار منشور. لا تتحقق عملية التحقق في بيئة الاختبار من صحة أرقام الهوية الحقيقية.
سيناريو المحاكاة مغلق
أكمل الشروط المسبقة للسياسة المعروضة أو الشروط الخاصة بالتجهيزات الخاضعة للرقابة.
لا يمكن استرداد مورد العينة
توضح عينات الكتالوج الأشكال؛ معرفاتها ليست موارد مخزنة مباشرة.
افتح مراجع الإعداد والتكامل
افتح أداة لوحة التحكم (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
