सामग्री पर जाएँ
लाइव डेमो
ब्लॉग

होटल उपलब्धता API: धीमे सप्लायरों के लिए डिज़ाइन

Tekravel संपादकीय
AI की मदद से लिखा गया

टिकट आम तौर पर बड़ा मासूम दिखता है: "बुकिंग पेज पर होटल सर्च जोड़ दो — सप्लायर ने हमें होटल उपलब्धता API दे दिया है, सैंडबॉक्स भी है, एक स्प्रिंट का काम है।" आप डॉक्यूमेंटेशन पढ़ते हैं, गोवा में दो वयस्कों के लिए तीन रातों का अनुरोध भेजते हैं, और जवाब आ जाता है। फिर आप वही अनुरोध एक ऐसे शहर के लिए भेजते हैं जहाँ होटल कहीं ज़्यादा हैं, और काफ़ी देर तक, असहज रूप से देर तक, कुछ नहीं आता। जब आता है, तो वह इतना बड़ा दस्तावेज़ होता है कि आपका JSON पार्सर अपने करियर पर दोबारा सोचने लगे।

काम का स्वरूप ठीक इसी पल बदल जाता है। होटल उपलब्धता कोई सीधा लुकअप नहीं है। यह एक fan-out है: यूज़र का एक सवाल कई सप्लायरों से पूछे गए कई सवालों में बदल जाता है, और हर सप्लायर अपनी रफ़्तार से, अपनी शब्दावली में, "कमरे" की अपनी परिभाषा के साथ जवाब देता है। आप जो क्लाइंट बना रहे हैं, उसे तब भी काम का रहना है जब यह फैलाव अभी पूरा नहीं हुआ है। यह लेख उसी क्लाइंट को डिज़ाइन करने के बारे में है — उस डेवलपर के लिए जो REST और JSON अच्छी तरह जानता है, पर जिसे कभी किसी होटल को यह नहीं समझाना पड़ा कि नॉन-रिफ़ंडेबल रेट मेहमान को फ़्री कैंसलेशन वाला क्यों दिखा।

होटल उपलब्धता API आपके जाने-पहचाने एंडपॉइंट से धीमा क्यों है

फ़्लाइट सर्च और होटल सर्च बाहर से एक जैसे लगते हैं: एक क्वेरी जाती है, क़ीमत वाले विकल्प लौटते हैं। अंदर से ये एक ही समस्या नहीं हैं। अगर आपने हमारा लेख पढ़ा है कि फ़्लाइट बुकिंग API इंटीग्रेशन में असल में क्या-क्या शामिल है, तो आप जानते हैं कि सर्च की क़ीमत हमेशा बुकिंग की क़ीमत नहीं होती। होटल इसके ऊपर एक दूसरी मुश्किल जोड़ते हैं: मात्रा।

एक ही शहर में सैकड़ों प्रॉपर्टी हो सकती हैं। हर प्रॉपर्टी कई तरह के कमरे बेचती है। हर रूम टाइप कई रेट प्लान में बिकता है — नाश्ते के साथ, बिना नाश्ते के, रिफ़ंडेबल, नॉन-रिफ़ंडेबल, मेंबर रेट, पैकेज रेट। और हर रेट प्लान एक से ज़्यादा सप्लायर से आ सकता है: कोई bedbank, कोई चैनल मैनेजर, कोई डायरेक्ट कॉन्ट्रैक्ट, या कोई होलसेलर जिसके साथ आपने इसलिए साइन किया क्योंकि किसी ख़ास होटल में उसका allotment बाक़ियों से बेहतर था। इन सबको गुणा कीजिए, और एक "सीधी-सादी" सर्च एक बड़ा पेड़ बन जाती है, जो ऐसे स्रोतों से जोड़ा गया है जो न नामों पर सहमत हैं, न IDs पर।

इसलिए धीमा हिस्सा शायद ही कभी आपका कोड होता है। धीमा हिस्सा वह सबसे सुस्त सप्लायर है जिसका इंतज़ार करना आपने चुना।

प्रोग्रेसिव नतीजे या पूरा जवाब: सोच-समझकर चुनें

होटल सर्च के नतीजे लौटाने के दो ईमानदार तरीक़े हैं, और ज़्यादातर इंटीग्रेशन दोनों के बीच किसी असहज जगह पर अटक जाते हैं।

सबका इंतज़ार करें। आपका बैकएंड अनुरोध बाँटता है, हर सप्लायर के जवाब देने या टाइमआउट होने तक रुकता है, फिर मिलाता है, डुप्लिकेट हटाता है, क्रम लगाता है और एक पूरी सूची लौटाता है। नतीजा साफ़-सुथरा होता है: एक अनुरोध, एक जवाब, और क़ीमतें तुलना के लायक़ क्योंकि सब मेज़ पर हैं। क़ीमत यह है कि यूज़र हर बार उतनी देर स्पिनर देखता है जितनी देर आपका सबसे धीमा सप्लायर लेता है।

जो आया, वह भेजते जाएँ। बैकएंड बँटवारा शुरू करता है और फ़ौरन एक सर्च हैंडल लौटा देता है। क्लाइंट उस हैंडल को पोल करता है या एक स्ट्रीम खुली रखता है, और जैसे-जैसे सप्लायर जवाब देते हैं, नतीजे बैच में पाता है। पहले होटल जल्दी दिखते हैं। क़ीमत बाक़ी हर जगह की जटिलता है: यूज़र जब सूची पढ़ रहा होता है तभी उसका क्रम बदल जाता है, "सबसे सस्ता" बैज खिसक सकता है, और एक सप्लायर से आया होटल बाद में दूसरे सप्लायर से सस्ता रेट पा सकता है।

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

आप जो भी चुनें, तीन नियम प्रोग्रेसिव क्लाइंट को संतुलित रखते हैं:

  • हर बैच पूरी सर्च का एक पूर्णता स्टेटस साथ लाता है, ताकि क्लाइंट "अभी और नतीजे नहीं" और "अब कोई नतीजा नहीं आएगा" में फ़र्क़ कर सके।
  • नतीजे सर्वर पर एक स्थिर होटल की (key) से मर्ज होते हैं, बस आख़िर में जोड़े नहीं जाते। क्लाइंट को कभी ख़ुद यह अंदाज़ा नहीं लगाना चाहिए कि दो कार्ड एक ही इमारत के हैं।
  • क़ीमत के हिसाब से क्रम सर्च पूरी होने तक अस्थायी है, और इंटरफ़ेस यह साफ़ कहता है। यूज़र धीरे-धीरे स्थिर होती सूची को माफ़ कर देते हैं; ग़लत निकले "सबसे कम क़ीमत" लेबल को नहीं।

कमरों और रेट प्लान की मॉडलिंग ताकि सब ढह न जाए

यहीं पर ज़्यादातर होटल इंटीग्रेशन चुपचाप फ़ेल होते हैं, और यह विफलता महीनों बाद बग रिपोर्ट नहीं, बल्कि सपोर्ट टिकट के रूप में सामने आती है।

लुभावना मॉडल सपाट होता है: होटल के पास ऑफ़र की एक सूची, हर ऑफ़र में कमरे का नाम और क़ीमत। स्क्रीन पर अच्छा दिखता है। फिर एक सप्लायर साफ़ तौर पर एक ही कमरे के लिए "Deluxe King" और "Deluxe Room, 1 King Bed" लौटाता है, दूसरा दो सचमुच अलग कमरों (एक सिटी व्यू वाला, एक बिना) के लिए एक ही नाम देता है, और तीसरा प्रति रात की क़ीमत देता है जबकि बाक़ी सब पूरे ठहराव की। सपाट सूची आपको नहीं बता सकती कि सामने कौन-सा मामला है। वह बस दिखा देती है।

असली सप्लायरों से टकराकर टिकने वाले मॉडल में कम से कम चार स्तर होते हैं, और वह उन्हें अलग रखता है:

स्तरक्या रखता हैकिस ग़लती से बचना है
होटलआपकी अपनी स्थिर ID, हर सप्लायर के कोड से मैप की हुईकिसी सप्लायर की होटल ID को अपनी प्राइमरी की बनाना
कमराऑक्यूपेंसी, बेड कॉन्फ़िगरेशन, सप्लायर का मूल रूम टेक्स्ट जस का तसकमरों के नाम इतने "साफ़" करना कि दो अलग कमरे एक हो जाएँ
रेट प्लानमील प्लान, रिफ़ंड की शर्त, भुगतान का तरीक़ा, किस सप्लायर से आयानाश्ते या रिफ़ंडेबिलिटी को कमरे के नाम का हिस्सा मानना
क़ीमतपूरे ठहराव का कुल, मुद्रा, कौन-से टैक्स और फ़ीस शामिल हैं और कौन-से होटल में देने हैंपूरे ठहराव की क़ीमतों के बगल में प्रति रात की क़ीमत दिखाना, या पहुँचने पर देय फ़ीस छिपाना

आप इन सीमाओं से असहमत हो सकते हैं — कुछ टीमें ऑक्यूपेंसी को अलग स्तर बनाती हैं, जो मल्टी-रूम बुकिंग बेचते ही समझदारी है। जो नहीं कर सकते, वह है स्तरों को सिर्फ़ इसलिए मिला देना कि इंटरफ़ेस उनमें से दो ही दिखाता है। इंटरफ़ेस रेंडर करते समय सपाट कर सकता है। डेटा नहीं।

एक बात अलग वाक्य की हक़दार है: जो भी आप नॉर्मलाइज़ करें, उसके साथ सप्लायर का कच्चा रूम विवरण भी सहेजकर रखें। जब मेहमान पहुँचे और उसे वाउचर वाले से अलग कमरा मिले, तो हर कोई सबसे पहले यही पूछेगा कि सप्लायर ने असल में भेजा क्या था।

कैंसलेशन पॉलिसी डेटा है, कोई पैराग्राफ़ नहीं

कई सप्लायर कैंसलेशन की शर्तें खुले टेक्स्ट में भेजते हैं: "आगमन से 3 दिन पहले तक मुफ़्त कैंसलेशन, उसके बाद 1 रात का जुर्माना।" उस स्ट्रिंग को दिखाकर आगे बढ़ जाना बहुत आसान लगता है।

ऐसा न करें। टेक्स्ट की न तुलना हो सकती है, न क्रम लग सकता है, न फ़िल्टर, न लागू करना। आपका यूज़र रिफ़ंडेबल रेट तक फ़िल्टर करना चाहता है। आपकी फ़ाइनेंस टीम जानना चाहती है कि कौन-सी बुकिंग कल से नॉन-रिफ़ंडेबल हो जाएँगी, ताकि एजेंसी डेडलाइन से पहले ग्राहक से बात कर ले। बुकिंग के बाद का फ़्लो उसी पल ग्राहक को बताए कि कैंसल दबाते ही कितना कटेगा। इनमें से कुछ भी एक वाक्य पर नहीं चलता।

हर पॉलिसी को जुर्माने की खिड़कियों की क्रमबद्ध सूची के रूप में मॉडल करें: इस पल से उस पल तक जुर्माना इतना है (या ठहराव का इतना हिस्सा, या इतनी रातें)। सीमाएँ टाइमज़ोन वाले टाइमस्टैम्प हैं — होटल का टाइमज़ोन, न आपके सर्वर का, न यूज़र का — क्योंकि "आगमन से 3 दिन पहले" का मतलब इस पर निर्भर करता है कि आप किसकी आधी रात से गिन रहे हैं। सप्लायर का मूल टेक्स्ट संरचित संस्करण के साथ रखें, संरचित संस्करण दिखाएँ, और दोनों में फ़र्क़ हो तो उसे जाँचने की चीज़ मानें, छिपाने की नहीं।

और पॉलिसी बुकिंग के समय दोबारा जाँचें, सिर्फ़ सर्च के समय नहीं। दोनों कॉल के बीच पॉलिसी उतनी बार बदलती है जितना कोई सोचता भी नहीं।

ग़लती की असली क़ीमत

धीमी सर्च से कन्वर्ज़न घटते हैं — बुरा है, पर दिखता है; कोई न कोई शिकायत करेगा। महँगी विफलताएँ वे हैं जो चुपचाप होती हैं।

जो रेट रिफ़ंडेबल दिखाया गया पर सप्लायर उसे नॉन-रिफ़ंडेबल मानता है, उसका मतलब है स्क्रीनशॉट लिए बैठे ग्राहक से विवाद, और जुर्माना आम तौर पर एजेंसी ख़ुद भरती है। प्रति रात की क़ीमत को कुल ठहराव की क़ीमत बताकर दिखाना, तब तक लागत से कम पर कमरे बेचता रहता है जब तक अकाउंट्स में किसी की नज़र न पड़े। किसी दूसरे कमरे से मर्ज हुआ कमरा चार लोगों के परिवार को दो लोगों वाले कमरे में भेज देता है। होटल में देय फ़ीस जो कभी दिखाई नहीं गई, पाँच-सितारा रिव्यू को चार्जबैक में बदल देती है। इनमें से हर एक पहले स्प्रिंट में लिया गया मॉडलिंग फ़ैसला है, अक्सर "बाद में ठीक कर लेंगे" के नाम पर।

कैशिंग: क्या रख सकते हैं और क्या बिल्कुल नहीं

होटल API जोड़ने वाली हर टीम आख़िरकार पूछती है कि क्या सर्च तेज़ और सस्ती करने के लिए नतीजे कैश किए जा सकते हैं। जवाब है हाँ, कुछ चीज़ों के लिए — और उनके बीच की रेखा किसी भी परफ़ॉर्मेंस आँकड़े से ज़्यादा मायने रखती है।

स्टैटिक कंटेंट — होटलों के नाम, पते, निर्देशांक, फ़ोटो, सुविधाओं की सूची, कमरों के विवरण — कम बदलता है, और ठीक यही आपको अपने स्टोर में खुलकर कैश करना चाहिए। सप्लायर की शर्तें देख लें कि आप इसे कैसे रख और दिखा सकते हैं; कुछ लाइसेंस इस पर पाबंदी लगाते हैं। हर सर्च पर इसे लाइव मँगाना बेवजह धीमा है।

लाइव रेट और उपलब्धता अलग मामला है। कैश की गई क़ीमत इस बात का अनुमान है कि सप्लायर कितना लेगा, और सप्लायर आपके अनुमान नहीं मानते। पेज दिखाने के लिए सर्च नतीजों की थोड़ी देर की कैशिंग चल सकती है — बशर्ते हर बुकिंग पाथ पैसा लेने से पहले सप्लायर से दोबारा क़ीमत ले, और इंटरफ़ेस बदली हुई क़ीमत को ग़लती नहीं, सामान्य नतीजा माने। कुछ सप्लायर यह भी सीमित करते हैं कि बुकिंग के मुक़ाबले आप कितनी सर्च कर सकते हैं; आपका असली ट्रैफ़िक उनसे छिपाने वाली आक्रामक कैशिंग भरोसे लायक़ रास्ता नहीं है।

जो कभी कैश नहीं करना है, वह है हर वह चीज़ जो एक प्रतिबद्धता है: होल्ड किया गया प्राइस टोकन, बुकिंग रेफ़रेंस, कैंसलेशन कोट। ये एक यूज़र और एक पल के होते हैं।

"हो गया" कहने से पहले

असली बुकिंग चलाने से पहले अपने इंटीग्रेशन पर चलाने लायक़ एक छोटी जाँच-सूची:

  • सर्च एक पूर्णता स्टेटस लौटाती है, और क्लाइंट उससे पहले और बाद में अलग बर्ताव करता है।
  • होटल आपकी अपनी ID से पहचाने जाते हैं, और हर सप्लायर का कोड उससे मैप है।
  • स्क्रीन जो भी दिखाए, आपके डेटा में कमरा, रेट प्लान और क़ीमत अलग-अलग ऑब्जेक्ट हैं।
  • हर क़ीमत बताती है कि वह प्रति रात है या पूरे ठहराव की, और पहुँचने पर क्या देय है।
  • कैंसलेशन पॉलिसी होटल के टाइमज़ोन में समयबद्ध जुर्माना खिड़कियों के रूप में सहेजी है, मूल टेक्स्ट के साथ।
  • बुकिंग पाथ किसी से पैसा लेने से पहले दोबारा क़ीमत लेता है और पॉलिसी फिर से पढ़ता है।
  • प्रतिबद्धता दर्शाने वाली कोई भी चीज़ कभी कैश से नहीं परोसी जाती।

अगर आप तौल रहे हैं कि यह सब हर सप्लायर के साथ अलग-अलग ख़ुद बनाएँ या किसी ऐसे प्लेटफ़ॉर्म से शुरू करें जो इन समस्याओं से पहले ही गुज़र चुका है, तो कॉन्ट्रैक्ट वाला पहलू कोड जितना ही अहम है — होटल कंसोलिडेटर कॉन्ट्रैक्ट और bedbank रेट पर हमारा लेख बताता है कि क्या माँगना चाहिए। हमारे अपने फ़्लाइट और होटल API सेल्फ़-सर्व की से नहीं, बातचीत से खुलते हैं; अगर आप यही रास्ता देखना चाहते हैं, तो ट्रैवल API पेज से वह बातचीत शुरू करें।

Fan-out कभी ख़त्म नहीं होता। अच्छा क्लाइंट बस यह दिखावा करना छोड़ देता है कि वह मौजूद नहीं है।

Tekravel संपादकीय

ट्रैवल टेक्नोलॉजी डेस्क

Tekravel का ट्रैवल टेक्नोलॉजी डेस्क इंडस्ट्री के लिए लिखता है: एजेंसी मालिक, कंसॉलिडेटर और वे डेवलपर जो इन्हें जोड़ते हैं। हर लेख प्रकाशित होने से पहले उसी प्लेटफ़ॉर्म पर जाँचा जाता है जिसका वह वर्णन करता है।