What is a webhook: यह वह मैसेज है जो कुछ होते ही एक ऐप दूसरे को भेजता है। जानें webhook कैसे काम करता है, उसे कैसे जाँचें और sona.to क्या भेजता है।
Webhook वह मैसेज है जो कुछ होते ही एक ऐप दूसरे ऐप को भेजता है, ताकि दूसरे ऐप को बार-बार पूछना न पड़े। आप पहले ऐप को एक पता देते हैं, और हर घटना होते ही वह उसकी जानकारी वहाँ भेज देता है। यह गाइड बताती है कि webhooks कैसे काम करते हैं, कैसे जाँचें कि webhook असली है और sona.to क्या भेजता है, जिसका सार webhooks पेज पर भी है।
Webhook क्या है?
ज़्यादातर ऐप दो तरीक़ों से डेटा साझा करते हैं। API में आपका सिस्टम पूछता है: "क्या पोस्ट पब्लिश हो गई?", और जवाब नहीं हो तो बाद में फिर पूछता है। Webhook में ऐप आपको बताता है: पोस्ट पब्लिश होते ही वह आपके चुने पते पर पोस्ट की जानकारी के साथ एक रिक्वेस्ट भेजता है।
इसलिए webhook एक HTTP रिक्वेस्ट है, आम तौर पर JSON बॉडी वाली POST, जो आपके नियंत्रण वाले URL पर भेजी जाती है। वह URL आपका अपना सर्वर हो सकता है, या n8n, Zapier, Make, Slack या किसी दूसरी सेवा का दिया webhook पता, जो रिक्वेस्ट आते ही एक वर्कफ़्लो शुरू कर देती है।
Webhook और API में फ़र्क़
API पूछने और बदलने के लिए है: पोस्ट की सूची लेना, पोस्ट बनाना, आँकड़े पढ़ना। Webhook ख़बर पाने के लिए है। ज़्यादातर इंटीग्रेशन दोनों इस्तेमाल करते हैं: पोस्ट बनाने के लिए API और यह जानने के लिए webhook कि वह कब पब्लिश हुई या फ़ेल हुई। API से बार-बार पूछना रिक्वेस्ट बर्बाद करता है और फिर भी देर से पता चलता है, जबकि webhook घटना होते ही पहुँच जाता है।
Webhook को कैसे जाँचें
जो भी आपका webhook पता जानता है, वह उस पर नक़ली रिक्वेस्ट भेज सकता है, इसलिए अच्छे से बना webhook साइन किया जाता है। भेजने वाला बॉडी और एक साझा secret से एक सिग्नेचर निकालता है, आम तौर पर HMAC SHA-256 से, और उसे एक हेडर में रखता है। आपकी तरफ़ उसी secret से वही सिग्नेचर निकाला जाता है और दोनों की तुलना constant-time comparison से की जाती है। अगर वे अलग हों, तो रिक्वेस्ट को नज़रअंदाज़ कर दिया जाता है।
साइन किए गए डेटा में टाइमस्टैम्प शामिल करने से रिप्ले भी रुकते हैं: एक बार पकड़ी गई रिक्वेस्ट बाद में दोबारा नहीं भेजी जा सकती, क्योंकि उसका टाइमस्टैम्प बहुत पुराना होता है।
sona.to में webhooks
sona.to चार घटनाओं के लिए webhooks भेजता है: पोस्ट पब्लिश हुई, पोस्ट फ़ेल हुई, साइट ऑडिट पूरा हुआ और साइट ऑडिट फ़ेल हुआ। आप चुनते हैं कि हर webhook को कौन सी घटनाएँ मिलें, ताकि चैट नोटिफ़ायर सिर्फ़ फ़ेल होने पर सुने जबकि रिपोर्टिंग शीट सब कुछ ले। Payload में वही फ़ील्ड नाम हैं जो sona.to API में हैं।
सेट करना। अपने डैशबोर्ड के API पेज पर पता पेस्ट करें, घटनाओं पर टिक लगाएँ और सेव करें। साइनिंग secret उसी पल एक बार दिखाया जाता है, इसलिए उसे तभी कॉपी कर लें।
सिग्नेचर। हर डिलीवरी में एक हेडर होता है जिसमें टाइमस्टैम्प और आपके secret से बना, टाइमस्टैम्प और बॉडी का HMAC SHA-256 होता है। जिन रिक्वेस्ट का टाइमस्टैम्प कुछ मिनट से ज़्यादा पुराना हो, उन्हें अस्वीकार करें।
दोबारा कोशिश। अगर आपका पता बंद है या एरर लौटाता है, तो डिलीवरी 60 सेकंड, 5 मिनट और 30 मिनट बाद फिर से की जाती है। हर कोशिश अपने स्टेटस कोड और अवधि के साथ लॉग होती है। जो पता लगातार फ़ेल होता है, वह बंद कर दिया जाता है, और ठीक होने पर आप उसे फिर चालू कर सकते हैं।
सुरक्षा। पते में https होना चाहिए और वह किसी सार्वजनिक सर्वर की ओर होना चाहिए। निजी नेटवर्क के पते सेव करते समय और फिर डिलीवरी के समय अस्वीकार किए जाते हैं, और रीडायरेक्ट फ़ॉलो नहीं किए जाते।
n8n, Zapier और Make के साथ webhooks
n8n, Zapier और Make के लिए sona.to ऐप्स में इन्हीं चार घटनाओं के लिए तैयार ट्रिगर हैं, इसलिए आपको ख़ुद पता पेस्ट नहीं करना पड़ता: ट्रिगर जोड़ें और ऐप webhook सेट कर देता है। देखें n8n, Zapier और Make से social media automation।
सिग्नेचर जाँचने के उदाहरण समेत पूरी जानकारी API डॉक्यूमेंटेशन में है।
अक्सर पूछे जाने वाले सवाल
क्या webhook और API एक ही चीज़ हैं?
नहीं। API तब जवाब देती है जब आप पूछते हैं। Webhook कुछ होने पर आपको मैसेज भेजता है।
क्या sona.to webhooks मुफ़्त हैं?
Webhooks, API के साथ, हर प्लान में शामिल हैं।
अगर मेरा सर्वर बंद हो तो क्या होगा?
sona.to लगभग आधे घंटे में तीन बार फिर कोशिश करता है। अगर डिलीवरी फ़ेल होती रहें, तो webhook तब तक बंद रहता है जब तक आप उसे फिर चालू न करें।
आज़माने के लिए तैयार हैं?
शुरुआत मुफ़्त है, क्रेडिट कार्ड की ज़रूरत नहीं।
