किसी endpoint का idempotent होना क्या मतलब रखता है, और आप एक create endpoint को idempotent कैसे बनाएंगे?

idempotent endpoint एक ही इनपुट पर एक बार बुलाने और पांच बार बुलाने, दोनों में वही नतीजा देता है। GET, PUT और DELETE स्वाभाविक रूप से idempotent हैं; POST नहीं है। create endpoint को idempotent बनाने के लिए client से एक अनोखी idempotency key भिजवाइए, उस key को बनाए गए resource के साथ उसी transaction में स्टोर कीजिए, और हर दोहराव पर वही पुराना नतीजा लौटाइए।

idempotent का मतलब है कि दो बार कॉल करने पर सिस्टम उसी हाल में रहता है जिस हाल में एक बार कॉल करने पर होता। PUT idempotent है क्योंकि आप आखिरी state बता रहे हैं; POST आम तौर पर नहीं है, क्योंकि हर कॉल का मतलब है एक और बनाओ। create endpoint के लिए मैं client से एक key बनवाता हूं, आम तौर पर UUID, और उसे header में भिजवाता हूं। सर्वर की तरफ मैं उस key को unique constraint वाली table में रखता हूं, और उसे resource के साथ उसी transaction में लिखता हूं, क्योंकि अगर ये दोनों commit अलग हो सकते हैं तो पूरी व्यवस्था सिर्फ सजावट है। अगर वही key दोबारा आती है, तो मैं उसे ढूंढकर पुराना response पुराने status के साथ लौटा देता हूं। जो हिस्सा लोग छोड़ देते हैं वह है एक साथ आने वाला केस, जहां दो retries एक ही मिलीसेकंड में आ जाती हैं। unique index उसे संभाल लेता है: दूसरा insert फेल होता है, मैं उस violation को पकड़ता हूं और error देने के बजाय जीतने वाली row पढ़ लेता हूं। मैंने यह एक payments endpoint के लिए बनाया था, जब एक network झटके के दौरान हमने किसी से दो बार चार्ज ले लिया था।