الأدلة
الأعطال وإعادة المحاولة والتكرار
الشبكات تتعطل. القاعدة الذهبية: كل عملية تُكرر بأمان، ولا يُعاد إرسال شيء قبل التأكد من مصيره.
الرد غير الواضح#
- نظامك ← ليتس بيتزاطلب كتابة مع Idempotency-Key
- ليتس بيتزا ← نظامكانقطع الاتصال: هل وصل؟
- نظامك ← ليتس بيتزاابحث أولاً
GET /partner/v1/orders/{id} - نظامك ← ليتس بيتزاإن لم يُطبّق: أعد بالمفتاح نفسه
القواعد#
- أرسل Idempotency-Key ثابتاً لكل عملية (من معرّف عملك)، وأعد استخدامه في كل محاولة لها.
- أعد المحاولة فقط عندما تكون retryable تساوي true، أو عند انقطاع الشبكة.
- بتباعد متزايد مع عشوائية بسيطة: 1 ث، 2 ث، 4 ث… حتى دقيقة، ثم أبلغ فريقك.
- احترم Retry-After عند 429.
- بعد انقطاع لا تعرف نتيجته: ابحث عن النتيجة أولاً، ثم أعد إن لزم.
الأحداث المكررة#
الإشعارات تصل مرة واحدة على الأقل، وقد تصل مرتين. خزّن معرّف كل حدث عالجته وتجاهل المكرر. التفاصيل.
الطلبات المستخدمة#
ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.