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