التكرار الآمن
كل طلبات POST و PATCH و DELETE تتطلب رأس Idempotency-Key.
Idempotency-Key: order-create-2026-04-30-abc123
الصيغة: 1–64 حرفًا من [A-Za-z0-9_-:.]. نحفظ الاستجابة في الذاكرة المؤقتة لمدة 24 ساعة لكل مفتاح. الإعادات تُرجع الاستجابة المخزَّنة مع رأس Idempotency-Replay: 1.
استخدم قيمة ثابتة وفريدة لكل عملية منطقية (مثل UUID مولَّد من جانب العميل).