اتفق على عقد واضح للتكامل
وثّق معنى الحقول والمعرّفات والقيم المطلوبة والملكية. عرّف النجاح وما يحدث عند تعطّل النظام المستقبل. ضمّن تغييرات الإصدارات والصلاحيات. اسم العميل المشترك ليس معرّفاً فريداً موثوقاً؛ استخدم مفتاحاً ثابتاً وخريطة صريحة بين سجلات الأنظمة.
اجعل إعادة المحاولة آمنة لكل عملية
قد ينجح الطلب في الطرف الآخر ويضيع الرد. تكرار الإنشاء عشوائياً قد يكرّر دفعة أو طلباً. استخدم آليات ثبات الأثر المدعومة أو تصميماً مقصوداً لمنع التكرار. ثبات الأثر يصف النتيجة المطلوبة لتكرار الطلب، ولا يشترط تطابق محتوى كل رد أو رمز حالته.
تحقق من الأحداث وتوقّع التأخير
تحقق من الإشعارات بطريقة المزود الموثّقة. تتبّع معرّفات الأحداث وتعامل مع التكرار واختلاف ترتيب الوصول. ضع مهلاً ومحاولات محدودة بفواصل متزايدة. انقل غير المحلول لقائمة مراجعة ظاهرة. لا تجعل الخطأ المؤقت يكرر إجراءات يصعب عكسها أو يراكم عملاً فاشلاً غير مرئي.
جهّز المطابقة وأدوات الدعم
احتفظ بمعرّفات تتبّع تربط المعاملة دون تسجيل أسرار. قارن المصدر والوجهة وفق جدول متفق عليه. امنح الدعم طريقة منضبطة لفحص الفشل وتسجيل الحل. اختبر الانقطاع والتكرار وتعطّل الوجهة قبل اعتبار الربط مكتملاً؛ عرض المسار الناجح يغطي جزءاً فقط.
مثال توضيحي: إشعار دفع يصل مرتين
افترض أن مزود الدفع أرسل حدث نجاح ثم أعاده لعدم استلام تأكيد. يتعرّف النظام المستقبِل على الحدث دون إنشاء أثر تجاري ثانٍ.
خزّن مرجعاً مناسباً وطبّق قواعد التحقق الخاصة بالمزود. اختبر وصول الإشعار قبل عودة المتصفح أو بعد مهلة أو بترتيب مختلف. هذا سيناريو توضيحي للتكامل.
جهّز عقد التكامل وقائمة مراجعة للفشل
- معرّفات ثابتة وملكية للحقول.
- تحقق من الهوية والأحداث والإجراءات المسموحة.
- قواعد المهلة وإعادة المحاولة ومنع التكرار.
- قائمة ظاهرة للأحداث غير المحلولة.
- تقارير مطابقة ومسؤول دعم.
حدّد ما يُعاد تلقائياً وما يحتاج مراجعة. لا تكرّر عملية مالية أو صعبة العكس لمجرد توافر آلية إعادة محاولة عامة.
اجعل التسليم مفهوماً لفريق الدعم
يستطيع موظف الدعم العثور على المعاملة ومعرفة آخر حالة مؤكدة والفريق المسؤول عن الخطوة التالية دون الاطلاع على أسرار. ضمّن تصعيداً موثقاً وسجلاً للحلول اليدوية.
حاكِ عطلاً مؤقتاً واستعد العمل المعلق أثناء القبول. التكامل غير مكتمل تشغيلياً إذا كان المطوّر وحده يستطيع معرفة إن كان الطلب الفاشل قد نجح لدى الطرف الآخر.



