वेबहुक पढ़िए, सब कुछ दो बार किए बिना

दुनिया का हर वेबहुक सिस्टम कम-से-कम एक बार पहुँचाता है, और पहली बार सबको हैरानी होती है। घटना दो बार आती है, ग्राहक को दो बार संदेश जाता है, और बग रिपोर्ट कहती है कि वेबहुक टूटा है। वह टूटा नहीं है: वह ठीक वही कर रहा है जिसका उसने वादा किया था।

दोहराव सामान्य क्यों है

• आपका हैंडलर धीमा था, इसलिए भेजने वाले ने इंतज़ार छोड़कर दोबारा कोशिश की।
• आपके हैंडलर ने काम कर लेने के बाद 500 लौटाया।
• आपके जवाब देने के बाद, पर जवाब पहुँचने से पहले, कनेक्शन टूट गया।
• किसी डिप्लॉय ने अनुरोध के बीच में प्रक्रिया दोबारा शुरू कर दी।

इनमें से सिर्फ़ एक आपके कोड की खराबी है, और चारों एक दोहरी प्रति पैदा करते हैं।

इलाज एक यूनीक बंदिश है

CREATE TABLE handled (
  event_id TEXT PRIMARY KEY,
  handled_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

अमल करने से पहले डालिए। अगर डालने में टकराव हो, तो इसे कोई पहले ही निपटा चुका है और आपका काम ख़त्म। यह बीच में हुए रीस्टार्ट से बच जाता है, जिससे स्मृति में रखा सेट नहीं बचता, और इसे न लाइब्रेरी चाहिए, न लॉक, न वर्करों के बीच कोई तालमेल।

इसके बाद लोग दो चीज़ें गलत करते हैं

वे 200 काम से पहले नहीं, काम के बाद लौटाते हैं, जो धीमे हैंडलर को दोहराए जाने वाले हैंडलर में बदल देता है। और वे हस्ताक्षर बॉडी पढ़ने के बाद जाँचते हैं, यानी जिसने भी URL खोजा उसका इनपुट वे पहले ही पढ़ चुके होते हैं। पहले हस्ताक्षर, दूसरा 200, तीसरा काम।

अक्सर पूछे जाने वाले सवाल