منع التكرار وإعادة المحاولة
أعد الطلب نفسه دون إنشاء عملية جديدة عن طريق الخطأ.
امنح كل تعديل معرّفًا ثابتًا
تتطلّب طلبات POST المعدّلة Idempotency-Key بطول من 8 إلى 200 حرف. أنشئه مرة لكل عملية مقصودة واحتفظ به عند إعادة المحاولة. استخدم مفتاحًا جديدًا لعملية جديدة.
Idempotency-Key: 451fa6b8-7e47-43e5-8fd1-72f18cd2a630المفتاح مرتبط بالطلب
تشمل الهوية المسجّلة العملية والهدف وجسم الطلب. يعيد الطلب المطابق الاستجابة المسجّلة. يتسبّب استخدام المفتاح لمحتوى أو هدف مختلف في تعارض. وتُفحص الصلاحيات مجدّدًا قبل إعادة الاستجابة.
احتفظ بمعرّف الرسالة أيضًا
يتضمّن إرسال الرسالة client_message_id أيضًا. احتفظ بهذا UUID وبـ Idempotency-Key عند إعادة الرسالة. لا يثبت أيّ منهما تنفيذ إجراء خارجي في نظام الأعمال.
أعد المحاولة بعناية
عند انتهاء مهلة الشبكة، أعد الطلب بالهوية نفسها مع انتظار متزايد ومحدود. افحص 409 قبل الإعادة؛ فقد يكون الطلب مختلفًا أو الحالة قديمة. احترم Retry-After عند وجودها. ولا تكرّر إجراءات أعمال لا تعرف نتيجتها.
واجهت صعوبة؟ تواصل معنا