इस पेज पर
देखें यह कैसे काम करता है
सचित्र पूर्वाभ्यास · काल्पनिक नमूना डेटा
एक सार्वजनिक HTTPS समापन बिंदु बनाएं
सार्वजनिक HTTPS URL के साथ एक वेबहुक जोड़ें। लोकलहोस्ट, निजी पते, यूआरएल क्रेडेंशियल, टुकड़े और रीडायरेक्ट गंतव्य स्वीकार नहीं किए जाते हैं।
यह प्रदर्शन आपके खाते को नहीं बदलता है।
सभी चरण पढ़ें
- एक सार्वजनिक HTTPS समापन बिंदु बनाएं
सार्वजनिक HTTPS URL के साथ एक वेबहुक जोड़ें। लोकलहोस्ट, निजी पते, यूआरएल क्रेडेंशियल, टुकड़े और रीडायरेक्ट गंतव्य स्वीकार नहीं किए जाते हैं।
- लेबल
- डेमो SMS रिसीवर
- समापन बिंदु
- https://example.com/sms-webhook
- एक बार का रहस्य सहेजें
दिखाए जाने पर रहस्य को अपने सर्वर के संरक्षित कॉन्फ़िगरेशन में कॉपी करें। यह बाद के प्रदर्शन के लिए उपलब्ध नहीं है; इसे टिकट या सार्वजनिक कोड में न डालें।
- हस्ताक्षर रहस्य
- ••••••••
- रॉ-बॉडी हस्ताक्षर सत्यापित करें
हस्ताक्षर रहस्य के साथ कच्चे अनुरोध निकाय पर HMAC-SHA256 को सत्यापित करें और x-TextVerified-हस्ताक्षर मान की तुलना करें। डुप्लिकेट हटाने के लिए स्थिर X-Webhook-event-id का उपयोग करें।
- सिग्नेचर हेडर
- x-TextVerified-हस्ताक्षर: sha256=<hex>
- घटना पहचान
- X-Webhook-event-id: डेमो-इवेंट-42
- सत्यापित करें
- HMAC-SHA256(गुप्त, रॉबॉडी)
- पुनः प्रयास को स्वीकार करें और संभालें
ईवेंट को सुरक्षित रूप से स्वीकार करने के तुरंत बाद 2xx लौटाएँ। विफल डिलीवरी उसी इवेंट पहचान के साथ 8 बार तक पुनः प्रयास कर सकती है; एक घटना को एक बार संसाधित करें। डिलीवरी से पहले स्वामित्व की दोबारा जाँच की जाती है।
- पहली डिलीवरी
- डेमो-इवेंट-42 → 2xx
- बार-बार डिलीवरी
- समान ईवेंट आईडी → कोई डुप्लिकेट कार्रवाई नहीं
- वेबहुक प्रबंधित करें
इसके लेबल या विवरण को संपादित करें, डिलीवरी को अस्थायी रूप से अक्षम करें, या जब आवश्यकता न हो तो इसे हटा दें। परिवर्तनों के दौरान अपने रिसीवर के डिडुप्लीकेशन और गुप्त हैंडलिंग को सुसंगत रखें।
- वेबहुक
- डेमो SMS रिसीवर
- स्थिति
- अक्षम
एक सार्वजनिक समापन बिंदु जोड़ें
डेवलपर्स में, वेबहुक खोलें और एंडपॉइंट जोड़ें। एक लेबल, सार्वजनिक HTTPS URL और वैकल्पिक विवरण दर्ज करें। लोकलहोस्ट, प्राइवेट-नेटवर्क पते, यूआरएल और रीडायरेक्ट में क्रेडेंशियल अनुपयुक्त हैं। अंतिम गंतव्य को सीधे पहुंच योग्य बनाएं।
निर्माण के बाद, मोडल द्वारा दिखाए गए रहस्य को कॉपी करें और सुरक्षित रूप से सहेजें। कॉपी करने से यह डिस्प्ले साफ़ हो जाता है; इसे बाद में पढ़ने में सक्षम होने पर भरोसा न करें। इसे API कुंजियों से अलग रखें और सार्वजनिक कोड से बाहर रखें।
मूल अनुरोध निकाय को सत्यापित करें
इवेंट JSON POST अनुरोध के रूप में आते हैं। सटीक कच्चे अनुरोध निकाय पर वेबहुक रहस्य के साथ HMAC-SHA256 की गणना करें, फिर X-Webhook-signature, स्वरूपित sha256=HEX_DIGEST के साथ तुलना करें। सत्यापित करने से पहले JSON को पार्स और पुनः क्रमांकित न करें; व्हाइटस्पेस हस्ताक्षर बदल सकता है। अपने कार्यान्वयन में निरंतर-समय तुलना का उपयोग करें।
स्थिर घटना पहचानकर्ता के रूप में X-Webhook-event-id का उपयोग करें। प्रामाणिकता सत्यापित करें, उस पहचानकर्ता को डुप्लिकेट करें, कार्य को सुरक्षित रूप से रिकॉर्ड/कतारबद्ध करें और तुरंत 2xx प्रतिक्रिया लौटाएं। बॉडी फ़ील्ड के लिए वर्तमान ईवेंट अनुबंध का पालन करें।
पुनः प्रयास की अपेक्षा करें और समापन बिंदु प्रबंधित करें
डिलीवरी गैर-2xx प्रतिक्रियाओं को पुनः प्रयास कर सकती है या बैकऑफ़ के साथ आठ प्रयासों तक टाइमआउट कर सकती है, इसलिए एक ही ईवेंट एक से अधिक बार आ सकता है। आपके हैंडलर को डुप्लिकेट सहन करना होगा. रीडायरेक्ट को सफल 2xx गंतव्य प्रतिक्रिया के रूप में नहीं गिना जाता है।
तालिका लेबल/विवरण को संपादित करने, अक्षम करने और हटाने का समर्थन करती है। डिलीवरी रोकने को अक्षम करें; हटाने से समापनबिंदु हट जाता है। वर्तमान स्वामित्व संदेशों को नियंत्रित करता है, जिसमें स्थानांतरण के बाद भी शामिल है। विफलताओं के लिए, अपने HTTPS समापन बिंदु, हस्ताक्षर प्रबंधन और सर्वर लॉग की जाँच करें; यह न मानें कि डैशबोर्ड में पूर्ण डिलीवरी-लॉग व्यूअर है।
आपके खाते के संबंध में सहायता चाहिए?
खुला समर्थन