Mercateer के फ्रंट-ऑफिस इवेंट वेबहुक के रूप में पाएँ
किसी एंडपॉइंट को Mercateer के इवेंट पर सब्सक्राइब करें और कॉल ख़त्म होते ही, लीड आते ही या काम बुक होते ही साइन किया हुआ पेलोड पाएँ। एंडपॉइंट API या डैशबोर्ड से रजिस्टर और मैनेज करें, और हर डिलीवरी की जाँच HMAC से करें।
Webhooks क्या है?
वेबहुक, Mercateer के फ्रंट-ऑफिस इवेंट को रियल टाइम में आपके अपने URL पर भेजते हैं, ताकि आपके सिस्टम बार-बार API पूछे बिना प्रतिक्रिया दे सकें। हर डिलीवरी एक JSON पेलोड होती है जो HMAC से साइन की जाती है, एंडपॉइंट आप API या डैशबोर्ड से रजिस्टर और मैनेज करते हैं, और फेल हुई डिलीवरी बढ़ते अंतराल के साथ दोबारा भेजी जाती हैं।
Webhooks के साथ आप क्या कर सकते हैं
मिनटों में सेट अप
एक एंडपॉइंट बनाएँ
अपना URL रजिस्टर करें और सब्सक्राइब करने के लिए इवेंट चुनें, API से या Settings, फिर Developer में जाकर। Mercateer उस एंडपॉइंट के लिए एक साइनिंग सीक्रेट देता है। API एक्सेस Crew और Fleet प्लान में शामिल है।
सिग्नेचर की जाँच करें
हर डिलीवरी पर, सिग्नेचर हेडर से टाइमस्टैम्प (t) और सिग्नेचर (v1) पढ़ें, फिर अपने साइनिंग सीक्रेट के साथ "{timestamp}.{raw request body}" स्ट्रिंग का HMAC-SHA256 निकालें और उसकी तुलना v1 वैल्यू से करें। जो रिक्वेस्ट मेल न खाए, या जिसका टाइमस्टैम्प 5 मिनट से ज़्यादा पुराना हो, उसे ठुकरा दें, ताकि आप सिर्फ़ ताज़ा पेलोड पर काम करें जो सचमुच Mercateer से आए हों। (हमारे SDK का verify हेल्पर यह सब आपके लिए कर देता है।)
दोबारा भेजी गई डिलीवरी को आइडेम्पोटेंट तरीके से संभालें
डिलीवरी मिलने की पुष्टि के लिए जल्दी से 2xx जवाब दें। फेल हुई डिलीवरी बढ़ते अंतराल के साथ दोबारा भेजी जाती हैं, इसलिए अपने हैंडलर को इवेंट ID के आधार पर बनाएँ, ताकि दोहराव नज़रअंदाज़ हो और हर इवेंट एक ही बार प्रोसेस हो।
अक्सर पूछे जाने वाले सवाल
आपके पूरे सिस्टम के साथ काम करता है
Mercateer उन्हीं प्रोटोकॉल पर चलता है जिन पर आपके मौजूदा टूल चलते हैं।
Mercateer को Webhooks के साथ काम पर लगाएँ
मुफ़्त शुरू करें और मिनटों में अपना फ्रंट ऑफिस जोड़ें।
क्रेडिट कार्ड की ज़रूरत नहीं