वेबहुक एकीकरण

वेबहुक आपके सिस्टम को आपके Wink खाते पर होने वाली घटनाओं जैसे नई बुकिंग, रद्दीकरण, भुगतान अपडेट और अधिक के लिए रियल-टाइम सूचनाएं प्राप्त करने देते हैं। यह गाइड आपको सेटअप और सर्वोत्तम प्रथाओं के माध्यम से मार्गदर्शन करता है।

दर्शक

यह गाइड उन डेवलपर्स के लिए है जो Wink को बाहरी सिस्टम जैसे प्रॉपर्टी मैनेजमेंट सिस्टम (PMS), चैनल मैनेजर, CRM, या कस्टम डैशबोर्ड के साथ एकीकृत कर रहे हैं।

वेबहुक कैसे काम करते हैं

1. आप Wink पर एक वेबहुक URL पंजीकृत करते हैं।
2. जब कोई घटना होती है (जैसे, नई बुकिंग), Wink आपके URL पर HTTP POST भेजता है।
3. आपका सर्वर पेलोड को प्रोसेस करता है और 200 OK के साथ प्रतिक्रिया देता है।

वेबहुक सेटअप करना

1. अपने खाते में लॉग इन करें (Extranet, Studio, या TripPay — सभी वेबहुक का समर्थन करते हैं)।
2. Applications पर जाएं और फिर Webhooks पर जाएं। देखें Webhooks।
3. Create webhook पर क्लिक करें।
4. एक नाम दर्ज करें (जैसे, “PMS Booking Sync”)।
5. अपना वेबहुक URL दर्ज करें — आपके सर्वर पर HTTPS एंडपॉइंट।
6. इवेंट चुनें — सदस्यता के लिए विशिष्ट घटनाएं चुनें, या सभी घटनाएं प्राप्त करने के लिए खाली छोड़ दें।
7. Enabled को चालू करें।
8. Save पर क्लिक करें।

घटना प्रकार

Wink विभिन्न प्रकार की घटनाओं का समर्थन करता है। सामान्य घटनाओं में शामिल हैं:

• बुकिंग बनाई गई — एक नई बुकिंग की पुष्टि हो गई है।
• बुकिंग रद्द की गई — एक बुकिंग रद्द कर दी गई है।
• भुगतान पूरा हुआ — भुगतान संसाधित हो गया है।
• बुकिंग अपडेट की गई — बुकिंग के विवरण बदल गए हैं।

संकेत

सभी घटनाओं की सदस्यता लेकर शुरू करें। एक बार जब आप पेलोड को समझ लें, तो आप केवल उन घटनाओं तक सीमित कर सकते हैं जिनकी आपके सिस्टम को आवश्यकता है।

सर्वोत्तम प्रथाएं

• HTTPS का उपयोग करें — Wink केवल HTTPS एंडपॉइंट्स को पेलोड भेजता है।
• त्वरित प्रतिक्रिया दें — पेलोड प्राप्त होते ही 200 OK लौटाएं। कोई भी भारी प्रोसेसिंग असिंक्रोनस रूप से करें।
• इडेम्पोटेंसी — आपका हैंडलर इडेम्पोटेंट होना चाहिए। यदि Wink को 200 प्रतिक्रिया नहीं मिलती है तो वह डिलीवरी पुनः प्रयास कर सकता है।
• स्रोत सत्यापित करें — प्रोसेसिंग से पहले सुनिश्चित करें कि आने वाले अनुरोध Wink से हैं।
• लॉगिंग — हर वेबहुक पेलोड को लॉग करें जो आप प्राप्त करते हैं। इससे एकीकरण समस्याओं का डिबगिंग आसान हो जाता है।

रोकना और हटाना

आप एक वेबहुक को अक्षम कर सकते हैं बिना उसे हटाए। यह डिलीवरी को रोकता है ताकि आप बिना अपनी कॉन्फ़िगरेशन खोए समस्या निवारण कर सकें। जब आप तैयार हों, तो इसे फिर से चालू करें।

वेबहुक को हटाने से वह स्थायी रूप से हटा दिया जाता है। उस वेबहुक पर निर्भर कोई भी एकीकरण सूचनाएं प्राप्त करना बंद कर देगा।

आगे पढ़ें

• Webhooks — वेबहुक प्रबंधन के लिए पूर्ण संदर्भ।
• Applications — अपने API क्रेडेंशियल्स प्रबंधित करें।
• Developers > APIs — पूर्ण API दस्तावेज़।