​

आइडेम्पोटेंसी

​

इसे कब भेजें

• कोई client transport failure के बाद retry कर सकता हो।
• कोई queue worker एक ही logical operation को एक से अधिक बार dispatch कर सकता हो।
• कोई AI agent partial progress या tool retries के बाद mutation को फिर से चला सकता हो।

​

अनुशंसित पैटर्न

• प्रति logical mutation एक स्थिर key जनरेट करें।
• उस mutation के retries के लिए वही key पुनः उपयोग करें।
• जब intended mutation बदल जाए, तो key बदल दें।

​

उदाहरण

Idempotency-Key: create-project-song-1

Idempotency-Key: export-song-1

​

अच्छी सीमाएँ

• किसी project को बनाने के लिए एक key।
• उसी project को export करने के लिए अलग key।
• project settings को अपडेट करने के लिए फिर से एक अलग key।