إعادة المحاولة بأمان

يمكن تكرار GET بحرية. مع POST أرسل ترويسة Idempotency-Key، بسلسلة فريدة حتى 255 حرفًا، ويفضل UUID، ولن تُنفّذ العملية أكثر من مرة مهما كررت الطلب:

Idempotency-Key: 8f14e45f-ea6a-4cbb-9a2f-3d1c0b7e21aa

• كرر بـالمفتاح نفسه والجسم نفسه لتحصل على استجابة الطلب الأول مع Idempotent-Replay: true. لا يُنفّذ شيء مرتين.
• يُرفض المفتاح نفسه مع جسم مختلف بالرمز 409 idempotency_key_reuse. ولّد مفتاحًا لكل عملية منطقية، لا لكل عملية تشغيل.
• لا يحتفظ الطلب الفاشل بمفتاحه؛ تنفّذه المحاولة الجديدة مجددًا، وهو المطلوب بعد انتهاء المهلة أو 5xx.
• تُحفظ المفاتيح 24 ساعة.

دون الترويسة يُنفّذ POST المكرر كاملًا مرة أخرى. مع POST /organization/keys يعني ذلك إنشاء مفتاح ثانٍ لا يُعرض سره إلا مرة واحدة، لذا أرسل الترويسة.