Webhook एक HTTP अनुरोध है जो एक सेवा एक URL पर भेजती है जिसे आप पंजीकृत करते हैं जब भी कोई विशेष घटना होती है। यह आपके सिस्टम को डेटा प्राप्त करने की अनुमति देता है जैसे ही यह होता है, इसके बजाय कि आप एक API को बार-बार कॉल करके यह देखने के लिए कि क्या कुछ नया उपलब्ध है। एक डेटा पाइपलाइन में, इसका मतलब है कि एक कार्य घटना पर प्रतिक्रिया कर सकता है जैसे ही स्रोत इसे रिपोर्ट करता है।

भुगतान प्लेटफ़ॉर्म Stripe, उदाहरण के लिए, HTTPS के माध्यम से आपके एंडपॉइंट पर JSON पेलोड के रूप में webhook घटनाएँ भेजता है। आपके एंडपॉइंट को POST अनुरोध स्वीकार करना चाहिए और इसे प्राप्त होने वाले घटना डेटा को संसाधित करना चाहिए।

Webhook डिलीवरी कैसे काम करती है

Stripe का दस्तावेज़ मुख्य तंत्र दिखाता है:

  • पंजीकरण: आप एक एंडपॉइंट URL पंजीकृत करते हैं। लाइव मोड में, Stripe एक सार्वजनिक रूप से सुलभ HTTPS URL की आवश्यकता होती है।
  • तेज़ स्वीकृति: एंडपॉइंट को जल्दी से 2xx स्थिति कोड लौटाना चाहिए, किसी भी जटिल लॉजिक से पहले जो टाइमआउट का कारण बन सकता है।
  • पुनः प्रयास: यदि डिलीवरी विफल होती है, तो Stripe लाइव मोड में तीन दिनों तक पुनः प्रयास करता है जिसमें वृद्धि के साथ बैकऑफ होता है।
  • क्रम: Stripe यह सुनिश्चित नहीं करता है कि घटनाएँ उसी क्रम में आती हैं जिसमें उन्हें बनाया गया था।

Webhook एंडपॉइंट को सुरक्षित करना

  • हस्ताक्षर सत्यापित करें: Stripe प्रत्येक घटना को SHA-256 का उपयोग करके HMAC के साथ हस्ताक्षरित करता है और हस्ताक्षर को Stripe-Signature हेडर में रखता है।
  • पुनः प्रयासों को ब्लॉक करें: हस्ताक्षरित पेलोड में एक टाइमस्टैम्प शामिल होता है, इसलिए आप बहुत पुरानी घटनाओं को अस्वीकार कर सकते हैं।
  • डुप्लिकेट को संभालें: एक एंडपॉइंट एक ही घटना को एक से अधिक बार प्राप्त कर सकता है। संसाधित घटना IDs को लॉग करें और पुनरावृत्तियों को छोड़ दें।
  • सेंडर्स की अनुमति सूची: Stripe एक प्रकाशित IP पते की सूची से webhooks भेजता है जिसे आप अपने फ़ायरवॉल पर प्रतिबंधित कर सकते हैं।

सामान्य Webhook उपयोग

  • कोड और तैनाती: GitHub आपके URL पर HTTP POST पेलोड भेजता है उन रिपॉजिटरी घटनाओं के लिए जिनकी आप सदस्यता लेते हैं। इसके दस्तावेज़ों में CI निर्माण शुरू करने, एक बाहरी समस्या ट्रैकर को अपडेट करने, एक बैकअप मिरर को ताज़ा करने और उत्पादन सर्वर पर तैनाती जैसे उपयोगों की सूची है।
  • भुगतान: Stripe webhooks आपको असिंक्रोनस घटनाओं पर प्रतिक्रिया करने की अनुमति देते हैं, जैसे कि एक बैंक द्वारा भुगतान की पुष्टि करना, एक ग्राहक द्वारा चार्ज का विवाद करना या एक आवर्ती भुगतान सफल होना।
  • केवल वही सब्सक्राइब करें जिसकी आपको आवश्यकता है: Stripe अतिरिक्त या सभी घटनाओं के लिए सुनने के खिलाफ सलाह देता है क्योंकि यह आपके सर्वर पर अनावश्यक दबाव डालता है।

संबंधित शर्तें