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