مطوّرو ليتس بيتزاv1.0.0

الأدلة

الأعطال وإعادة المحاولة والتكرار

الشبكات تتعطل. القاعدة الذهبية: كل عملية تُكرر بأمان، ولا يُعاد إرسال شيء قبل التأكد من مصيره.

الرد غير الواضح#

  1. نظامك ← ليتس بيتزاطلب كتابة مع Idempotency-Key
  2. ليتس بيتزا ← نظامكانقطع الاتصال: هل وصل؟
  3. نظامك ← ليتس بيتزاابحث أولاًGET /partner/v1/orders/{id}
  4. نظامك ← ليتس بيتزاإن لم يُطبّق: أعد بالمفتاح نفسه

القواعد#

  1. أرسل Idempotency-Key ثابتاً لكل عملية (من معرّف عملك)، وأعد استخدامه في كل محاولة لها.
  2. أعد المحاولة فقط عندما تكون retryable تساوي true، أو عند انقطاع الشبكة.
  3. بتباعد متزايد مع عشوائية بسيطة: 1 ث، 2 ث، 4 ث… حتى دقيقة، ثم أبلغ فريقك.
  4. احترم Retry-After عند 429.
  5. بعد انقطاع لا تعرف نتيجته: ابحث عن النتيجة أولاً، ثم أعد إن لزم.

الأحداث المكررة#

الإشعارات تصل مرة واحدة على الأقل، وقد تصل مرتين. خزّن معرّف كل حدث عالجته وتجاهل المكرر. التفاصيل.

الطلبات المستخدمة#

ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.