عدم التكرار
تقبل جميع نقاط النهاية الخاصة بالطفراتPOST وPATCH ترويسة اختيارية Idempotency-Key.
متى ترسله
استخدم مفتاح عدم التكرار عندما:- قد يعيد العميل المحاولة بعد فشل في النقل.
- قد يرسل عامل قائمة انتظار العملية المنطقية نفسها أكثر من مرة.
- قد يعيد وكيل ذكاء اصطناعي تشغيل طفرة بعد تقدم جزئي أو بسبب إعادة محاولات الأدوات.
النمط الموصى به
- أنشئ مفتاحًا ثابتًا واحدًا لكل طفرة منطقية.
- أعد استخدام المفتاح نفسه عند إعادة المحاولة لتلك الطفرة.
- غيّر المفتاح عندما تتغير الطفرة المقصودة.
أمثلة
حدود جيدة
- مفتاح واحد لإنشاء مشروع.
- مفتاح مختلف لتصدير ذلك المشروع.
- مفتاح مختلف مرة أخرى لتحديث إعدادات المشروع.