كيفية الحصول على نتائج موثوقة مع Toden
Charles Archibong, المؤسس المشارك
استقبل نتائج Toden بشكل موثوق باستخدام مُستقبِل webhook مُوقّع. تحقّق من البايتات بدقة، وخزّن كل حدث بشكل دائم، واسترجع المحاولات المُعادَة دون تكرار إجراء العميل.
أهم النقاط
- يتم رفض التوقيعات التي تم التلاعب بها أو التي انتهت صلاحيتها.
- تؤدي إعادة الإرسال المنطقية إلى تنفيذ إجراء تجاري واحد.
- يستمر استعادة جهاز الاستقبال حتى بعد إعادة تشغيل العملية.
- لا يمكن للأحداث المتأخرة أن تحل محل الحالة الأحدث.
- يستمر نظام التناوب طوال فترة السماح الكاملة.
يستلم Toden نتائج موثوقة باستخدام مُستقبِل webhook مُوقّع. تحقق من البايتات بدقة، وخزّن كل حدث بشكل دائم، واسترجع المحاولات دون تكرار إجراء العميل.
قبل أن تبدأ
نقطة نهاية خادم تتحقق من التوقيعات
معالجة النسخ المكررة بشكل متين واستعادة المحاولات
شخص مرخص له API مفتاح استرجاع نتائج الخادم
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: تجهيز جهاز الاستقبال الخلفي
إنشاء عام HTTPS نقطة نهاية بشهادة صالحة وبدون إعادة توجيه. يجب أن تتلقى نص الطلب الخام تمامًا قبل JSON تُغيّر البرمجيات الوسيطة ذلك. خطط لصندوق وارد متين مُفهرس بمعرف حدث منطقي ومعالجة خلفية للعمليات البطيئة. يجب أن يكون المُستقبِل على خادمك الخلفي؛ لا يُعد رد الاتصال من المتصفح بديلاً عن تسليم النتائج بشكل موثوق.
مرجع التكامل: خوارزمية التحقق
الخطوة الثانية: إنشاء نقطة نهاية webhook الخاصة بالبيئة
في بيئة الاختبار، افتح قسم المطورين ← روابط الويب ← إضافة نقطة نهاية . أدخل نقطة النهاية .URL اختر إصدار الجسم المدعوم وحدد عائلات الأحداث التي يدعمها التكامل الخاص بك. حدد " إنشاء نقطة نهاية" واحفظ سر توقيع نقطة النهاية المعروض في مخزن الأسرار الخاص بالخادم الخلفي. احتفظ به منفصلاً عن... API المفتاح. تحتاج كل من بيئة الاختبار وبيئة الإنتاج إلى نقاط نهاية وأسرار مناسبة للبيئة.
مرجع التكامل: تسلسل الاختبار الموصى به
الخطوة 3: التحقق من توقيع الإصدار الثاني قبل التحليل
يقرأ X-Myaza-Signature-V2 قم بتحليل الطابع الزمني المُوقّع ومرشحي الإصدار الأول، وارفض الطوابع الزمنية غير الصالحة أو منتهية الصلاحية، ثم تحقق منها. HMAC - SHA256 تجاوز الطابع الزمني، ونقطة، والبايتات الخام بدقة. استخدم سر نقطة النهاية والمقارنة في وقت ثابت. أثناء التدوير، اقبل توقيعًا صالحًا من سر السماح النشط أو غير المنتهي الصلاحية. استخدم الموثق SDK أو مثال للمستلم بدلاً من صيغة توقيع مصطنعة.
مرجع التكامل: رؤوس مُوقّعة
الخطوة الرابعة: استمرار الحدث المنطقي قبل الإقرار
بعد التحقق من التوقيع، قم بتحليل JSON خزّن معرّف الظرف ضمن قيد فريد دائم. أزل العمليات التجارية المكررة باستخدام هذا المعرّف، وليس معرّف التسليم. يمكن أن يحمل اسم مستعار لإعادة الإرسال أو التوافق نفس الحدث المنطقي ضمن عملية تسليم أخرى. أرجع رمز 2xx فقط بعد القبول الدائم؛ ضع العمليات البطيئة في قائمة الانتظار بشكل منفصل. قد يفقد رمز 2xx السريع الذي لا يحتوي على سجل دائم النتيجة بعد حدوث عطل.
مرجع التكامل: تأكيد التكرار
الخطوة 5: مطابقة نتيجة المنتج الحالية
استخدم مرجع العميل أو التحقق أو المعاملة أو النشاط الموثق لمجموعة الأحداث. حافظ على فصل الحالة عن حالة التحقق (checkStatus) في عمليات التحقق. قد تصل الأحداث بترتيب غير متسلسل، لذا استرجع حالة المورد الحالية أو استخدم الإصدار المدعوم منها قبل إجراء أي تغيير حساس. يجب ألا تتسبب الحقول الاختيارية غير المعروفة وأنواع الأحداث غير المعروفة في تعطل جهاز الاستقبال. لا يُعد الإشعار وحده إذنًا بتحرير الأموال.
مرجع التكامل: تأكيد الترتيب
الخطوة السادسة: اختبار التسليم والإعادة والتناوب
افتح إجراء الاختبار الخاص بنقطة النهاية وأرسل حدثًا محاكاة مدعومًا. افحص سجل التسليم وسجل المُستقبِل الدائم. أعد إرساله وتأكد من تنفيذ الإجراء مرة واحدة. اختبر استجابة غير 2xx، والتعافي بعد انتهاء المهلة، وجسمًا مُعدّلًا، وتوقيعًا منتهي الصلاحية. قم بالتدوير باستخدام فترة السماح واختبر كلا التوقيعين قبل إلغاء سر المُستقبِل الأقدم.
مرجع التكامل: تسلسل الاختبار الموصى به
استفد أكثر من هذه الإمكانية
اشترك في مجموعات الأحداث الأساسية التي يحتاجها منتجك بدلاً من كل إدخال في الكتالوج بدون معالج.
قم بإبلاغ فريقك عن عمليات التسليم الفاشلة المتكررة أو التي تم تسليمها دون إشعار مسبق، واحتفظ بمسار للتسوية مع المورد الحالي.
قم بتخزين مراجع القرار الدقيقة والشرح مع الإجراء الخاص بك حتى يتمكن فريق الدعم من إثبات ما فعله التطبيق.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
يتم رفض التوقيعات التي تم التلاعب بها أو التي انتهت صلاحيتها.
تؤدي إعادة الإرسال المنطقية إلى تنفيذ إجراء تجاري واحد.
يستمر استعادة جهاز الاستقبال حتى بعد إعادة تشغيل العملية.
لا يمكن للأحداث المتأخرة أن تحل محل الحالة الأحدث.
يستمر نظام التناوب طوال فترة السماح الكاملة.
استكشاف الأخطاء وإصلاحها
فشل التوقيع بعد التحليل JSON
تحقق من البايتات الخام قبل تحليلها. تمت إعادة تسلسلها JSON يُغيّر المدخلات المُوقّعة.
تمت إعادة الإرسال مرتين
استخدم معرف الحدث المنطقي كمفتاح فريد دائم بدلاً من معرف التسليم.
تظهر عملية التسليم بنجاح، لكن الحساب لم يتغير.
فحص عمليات الأعمال المتراكمة والترابط بينها. HTTP التسليم ليس دليلاً على التأثير الجانبي اللاحق.
افتح مراجع الإعداد والتكامل
افتح أداة لوحة التحكم (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
