रिसोर्स · 54

वेबहुक: रिपीट, देरी और रिकवरी को हैंडल करें

मिले हुए नोटिफिकेशन को फेलियर के बाद रिकवर करने लायक एक यूनिक, ट्रेस करने लायक बिजनेस इफ़ेक्ट में बदलें।

अपडेटेड · 7 min

यह गाइड क्या पाने में मदद करती है

  • नोटिफ़िकेशन्स को ऑथेंटिकेट करें
  • रिसीट को प्रोसेसिंग से अलग करें
  • डुप्लीकेट इफ़ेक्ट्स को रोकें
  • ब्लॉक किए गए इवेंट्स को रिकवर करें

जल्दी से चेक करें

  • कौन से बाइट्स साइन किए गए हैं?
  • रिसीट कब ड्यूरेबल होती है?
  • क्या दो वर्कर्स एक साथ काम कर सकते हैं?
  • क्या प्रोवाइडर ऑर्डर की गारंटी देता है?
  • खोया हुआ इवेंट कैसे मिलता है?

स्टेप-बाय-स्टेप तरीका

  1. 1

    प्रोवाइडर कॉन्ट्रैक्ट पढ़ें

    टाइप्स, वर्शन, अकाउंट कॉन्टेक्स्ट, सिग्नेचर्स, टाइमिंग और रीट्राई रूल्स रिकॉर्ड करें। Stripe बताता है कि डिलीवरी ऑर्डरिंग की गारंटी नहीं है और डुप्लीकेट्स हो सकते हैं; हर API पर Stripe-स्पेसिफिक डिले लागू न करें।

    डिलीवरेबल: डेटेड प्रोवाइडर कॉन्ट्रैक्ट।

  2. 2

    इफ़ेक्ट से पहले वैलिडेट करें

    प्रोवाइडर के लिए ज़रूरी लाइब्रेरी और रॉ बॉडी से सिग्नेचर चेक करें। एक्सेप्टेड साइज़ और टाइप को लिमिट करें। सीक्रेट लॉग किए बिना ऑथराइज़्ड एनवायरनमेंट में इनवैलिड सिग्नेचर और अनएक्सपेक्टेड अकाउंट कॉन्टेक्स्ट को टेस्ट करें।

    डिलीवरेबल: बिना किसी इफ़ेक्ट के डिनायल।

  3. 3

    एक्सेप्ट करने से पहले परसिस्टेंट करें

    ड्यूरेबल रिसीट को स्लो प्रोसेसिंग से अलग करें। अगर क्यू इवेंट को एक्सेप्ट नहीं कर सकती है, तो इसे रिटेन्ड के तौर पर रिपोर्ट न करें। सक्सेस आपके कॉन्ट्रैक्ट के तहत रिसीट को दिखाता है, ज़रूरी नहीं कि बिज़नेस एक्शन पूरा हो।

    डिलीवरेबल: रिसीव्ड, प्रोसेसिंग, कम्प्लीटेड और ब्लॉक्ड स्टेट्स।

  4. 4

    आइडम्पोटेंसी लागू करें

    इवेंट कीज़ और बिज़नेस-इफ़ेक्ट आइडेंटिटी को डिफाइन करें। सिर्फ़ सीक्वेंशियल डिलीवरी के बजाय एक साथ रिपीट को टेस्ट करें। एटॉमिक कंस्ट्रेंट या लॉकिंग के बिना एक शुरुआती चेक दो वर्कर को एक ही इफ़ेक्ट बनाने की इजाज़त दे सकता है।

    डिलीवरेबल: इफ़ेक्ट यूनिकनेस का सबूत।

  5. 5

    देरी और गड़बड़ी को संभालें

    यह न मानें कि कोई पुराना नोटिफ़िकेशन मौजूदा स्थिति बताता है। जब कॉन्ट्रैक्ट इजाज़त दे तो सोर्स से सलाह लें और वैलिडेट किए गए बिज़नेस ट्रांज़िशन लागू करें। उन इवेंट्स को रखें जिन्हें अभी तक समझा नहीं जा सका है।

    डिलीवरेबल: ट्रांज़िशन और रिवर्स-ऑर्डर टेस्ट।

  6. 6

    रिकंसाइल और रीप्ले

    ओनर, कारण, कोशिशों और क्लोज़र के साथ एक एरर क्यू तैयार करें। रीप्ले के दौरान डुप्लीकेट प्रोटेक्शन रखें। समय-समय पर प्रोवाइडर और एप्लिकेशन की तुलना करें: सफल रिकवरी का मतलब यह नहीं है कि कोई इवेंट मिस नहीं हुआ।

    डिलीवरेबल: रिकवरी प्रोसीजर और डिस्क्रिपेंसी रिपोर्ट।

दोबारा इस्तेमाल होने वाली वर्कशीट

अपने ऑथराइज़्ड ऑब्ज़र्वेशन के साथ पूरा करें। ये फ़ील्ड एक वर्किंग टेम्पलेट हैं, देखे गए नतीजे नहीं।

फ़ील्डरिकॉर्ड करने के लिए जानकारी
इवेंटप्रोवाइडर, अकाउंट, आइडेंटिफ़ायर और वर्शन
रसीदवैलिडेटेड सिग्नेचर और ड्यूरेबल टाइमस्टैम्प
इफ़ेक्टबिज़नेस की, स्टेट और यूनिकनेस एविडेंस
रिकवरीकारण, कोशिश, ओनर और क्लोजर

काल्पनिक काम का उदाहरण

उदाहरण वाली स्थिति

काल्पनिक उदाहरण: रिकवरी के दौरान दो वर्कर को एक ही कन्फर्मेशन नोटिफ़िकेशन मिलता है।

फैसला और उम्मीद का सबूत

एक यूनिक बिज़नेस-इफ़ेक्ट कंस्ट्रेंट और ट्रांज़ैक्शनल स्टेट एक फ़ुलफ़िलमेंट की इजाज़त देता है, जबकि दोनों डिलीवरी ट्रेसेबल रहती हैं।

मैकेनिज़्म में अंतर बताएं

मैकेनिज़्ममकसदवेरिफ़िकेशन या लिमिटेशन
सिग्नेचरकॉन्ट्रैक्ट के तहत ओरिजिन को वैलिडेट करेंइफ़ेक्ट्स को यूनिक नहीं बनाता है
डीडुप्लीकेशनरिपीट नोटिफ़िकेशन पहचानेंकंकरेंसी और बिज़नेस इफ़ेक्ट भी चेक करें
रिकंसिलिएशनकमियां और अंतर ढूंढेंसोर्स और पीरियड बताएं

मैनेजमेंट इंडिकेटर

इंडिकेटरयह क्या मापता हैपहला एक्शन
क्यू एजअधूरे इवेंट में देरीसबसे पुराने को चेक करें
डुप्लीकेट इफ़ेक्टगलती से दोहराए गए बिज़नेस एक्शनएटॉमिसिटी ठीक करें
सोर्स / एप्लिकेशन गैपएब्सेंट या अलग-अलग स्टेट्सक्लोज़र एविडेंस के साथ रिकंसिल करें

आम गलतियाँ

  • साइन्ड-बॉडी वेरिफ़िकेशन से पहले पार्सिंग
  • ड्यूरेबल रिसीट से पहले एक्नॉलेज करना
  • ऑर्डर की गई डिलीवरी मान लेना
  • सिर्फ़ एक के बाद एक डुप्लीकेट टेस्ट करना

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

क्या HTTP सक्सेस का मतलब है कि प्रोसेसिंग पूरी हो गई है?

यह कॉन्ट्रैक्ट पर निर्भर करता है। एसिंक्रोनस प्रोसेसिंग के साथ, इसका मतलब ड्यूरेबल रिसीट होना चाहिए, जबकि बिज़नेस स्टेट को अलग से ट्रैक किया जाता है।

क्या एकदम एक बार डिलीवरी मानी जा सकती है?

असली कॉन्ट्रैक्ट के तहत रिपीट और फेलियर के लिए डिज़ाइन, यूनिक इफ़ेक्ट और रिकंसिलिएशन के साथ।

क्या पूरी बॉडी को बनाए रखना चाहिए?

सिर्फ़ तभी जब सही एक्सेस और रिटेंशन के साथ ज़रूरी हो। मिनिमम ट्रेस को सीक्रेट रखे बिना डायग्नोसिस और रिकवरी में सपोर्ट करना चाहिए।

ऑफ़िशियल रेफ़रेंस

रेफ़रेंस इस तरीके को सपोर्ट करते हैं। अपने कॉन्टेक्स्ट के हिसाब से चेक को एडजस्ट करें; वे सर्टिफ़िकेशन नहीं हैं। ओरिजिनल रेफ़रेंस टाइटल और सोर्स डॉक्यूमेंट दूसरी भाषा में हो सकते हैं।

संदर्भ जाँच की तारीख .