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