होटल और फ्लाइट बुकिंग API: एक यात्रा, दो बुकिंग

टिकट में लिखा है: "फ्लाइट फ़्लो में होटल जोड़ें, एक चेकआउट, एक कुल राशि।" प्रोडक्ट मैनेजर की यह माँग वाजिब है और एक दिन का काम लगती है, क्योंकि फ्लाइट सर्च और पेमेंट पेज आपके पास पहले से हैं। तीन हफ़्ते बाद टीम इस पर बहस कर रही है कि एयरलाइन ने कन्फ़र्म कर दिया पर होटल ने नहीं किया तो क्या होगा। होटल और फ्लाइट बुकिंग API दो तरह के नतीजों वाला एक इंटीग्रेशन नहीं है। यह एक टोकरी साझा करने वाले दो इंटीग्रेशन हैं।
कोड जितनी जल्दी यह मान लेता है, उतना कम हिस्सा दोबारा लिखना पड़ता है। आगे वह हिस्सा है जो इंटीग्रेशन गाइड छोड़ देती हैं: दोनों हिस्से कैसे अलग हैं, पहले कौन-सा कमिट करें, और आपके डेटा मॉडल में यात्रा क्या होनी चाहिए।
दोनों हिस्से एक जैसा व्यवहार नहीं करते
दोनों कीमत और रेफ़रेंस के साथ JSON में आते हैं, इसलिए तार पर एक जैसे दिखते हैं। रेफ़रेंस मिलने के बाद वे जो वादा करते हैं, वह एक जैसा नहीं है।
| सवाल | फ्लाइट | होटल |
|---|---|---|
| बुकिंग के बाद आपके पास क्या है | एक रिज़र्वेशन (PNR), जो अभी टिकट नहीं है | एक कन्फ़र्मेशन, जो आमतौर पर वही चीज़ है जो आपने बेची |
| कीमत कब तक मान्य है | बुकिंग पर किराए की दोबारा कीमत तय होने तक, जो सर्च से अलग हो सकती है | रेट की समाप्ति तक, और रेट उपलब्धता व बुकिंग के बीच बदल सकता है |
| कन्फ़र्म क्या करता है | टिकटिंग, अक्सर समय-सीमा के भीतर | सप्लायर की पुष्टि, कभी तुरंत, कभी लंबित |
| इसे कैसे पलटें | जल्दी पकड़ में आए तो void, वरना किराया नियमों के तहत रिफ़ंड, अक्सर जुर्माने के साथ | रेट की अपनी नीति के तहत रद्दीकरण, कई रेट पर एक कट-ऑफ़ तक मुफ़्त |
| बाद में राशि क्या बदलता है | किराया, टैक्स, कभी किराए की मुद्रा | प्रॉपर्टी पर चुकाए जाने वाले टैक्स और शुल्क, बोर्ड बेसिस, असल में दिया गया कमरा |
आप किसी पंक्ति से असहमत हो सकते हैं, क्योंकि सप्लायर अलग-अलग होते हैं, पर उसके स्वरूप से नहीं: एक हिस्से में टिकटिंग का चरण है और दूसरे में रद्दीकरण की खिड़की, और दोनों समय में मेल नहीं खाते। क्रम के फ्लाइट वाले हिस्से पर हमने फ्लाइट बुकिंग API इंटीग्रेशन में लिखा है, और होटल की ओर धीमे सप्लायर की समस्या पर होटल अवेलेबिलिटी API क्लाइंट डिज़ाइन में। यह लेख वहाँ से शुरू होता है जहाँ वे ख़त्म होते हैं, यानी जोड़ पर।
पहले कौन-सा बुक करें?
कोई नहीं बताता कि यह डिज़ाइन का फ़ैसला है, और यही तय करता है कि विफलता की क़ीमत क्या होगी।
मान लीजिए ग्राहक एक ही तारीख़ों के लिए फ्लाइट और होटल ख़रीदता है। आप एक बुकिंग भेजते हैं, फिर दूसरी। तीन चीज़ें हो सकती हैं: दोनों सफल हों, एक विफल हो, या एक दूसरे के सफल होने के बाद विफल हो। पहली अच्छा दिन है। बाक़ी दो आपकी सपोर्ट कतार तय करती हैं।
अगर आप पहले फ्लाइट का टिकट काट दें और होटल बाद में मना कर दे, तो आपके पास ऐसा ग्राहक है जिसके पास शहर की सीट है पर कमरा नहीं, जिसके पैसे कट चुके हैं, और जुर्माने वाले टिकट का रिफ़ंड। अगर पहले होटल बुक करें और फ्लाइट बाद में विफल हो, तो आपके पास ऐसा कमरा है जिसे अक्सर मुफ़्त रद्द किया जा सकता है, यानी मरम्मत सस्ती है। उलटा जोखिम भी असली है, क्योंकि रद्द न होने वाला होटल रेट रखने के लिए सबसे बुरी चीज़ है, इसलिए उसे पहले जाने देने से पहले रेट की रद्दीकरण शर्तें पढ़ें।
यह अंगूठे का नियम है, क़ानून नहीं; मुद्दा यह है कि क्रम जान-बूझकर चुनें। जो हिस्सा पलटना आसान है उसे कठिन वाले से पहले कमिट करें, किसी के भी कमिट होने से ठीक पहले दोनों कीमतें जाँचें, और तीनों नतीजों में से हर एक के लिए अपना क़दम लिख लें। समीक्षक कम ही पूछते हैं। ग्राहक हमेशा पता लगा लेते हैं।
एक यात्रा, दो बुकिंग
जो ढाँचा टिकता है, वह है एक ट्रिप रिकॉर्ड जिसके पास दो बुकिंग हैं, हर एक का अपना रेफ़रेंस, अपनी स्थिति और अपनी शर्तें। ग्राहक को एक कुल राशि दिखती है। आपके डेटाबेस को दो पंक्तियाँ दिखती हैं, और कुल राशि वह जोड़ है जो आप निकालते हैं, सप्लायर के पास मौजूद कोई चीज़ नहीं।
दोनों स्थितियाँ अलग रखें। होटल का "कन्फ़र्म्ड" और फ्लाइट का "टिकटेड" एक ही अवस्था नहीं हैं, और इन्हें चपटा करने वाला एकल स्टेटस कॉलम देर-सवेर आधी बुक हुई यात्रा पर "बुक्ड" लिख देगा।
बदलाव की शर्तें भी अलग रखें और दिखाएँ। दिखाई गई कुल राशि यह छिपा देती है कि तारीख़ें बदलना एक हिस्से पर मुफ़्त बदलाव है और दूसरे पर शुल्क। अगर आपका फ्रंट एंड "तारीख़ बदलें" को एक ही बटन के रूप में दिखाता है, तो ग्राहक के आपके लिए यह पता लगाने से पहले तय करें कि जब केवल एक हिस्सा खिसक सके तो वह क्या करेगा। यही मार्कअप पर लागू होता है: अगर आप ज़्यादातर विक्रेताओं की तरह इसे सेवा के हिसाब से जोड़ते हैं, तो यात्रा की कुल राशि दो मार्कअप है, और एक हिस्से के रिफ़ंड को पता होना चाहिए कि वह कौन-सा मार्कअप लौटा रहा है। पैसे में जुड़ी हुई यात्रा महँगी होती है, क्योंकि मदें अलग-अलग समय-रेखाओं पर निपटती हैं, और फ्लाइट का रिफ़ंड तब नहीं आता जब होटल का रद्दीकरण आता है।
यह प्लेटफ़ॉर्म कहाँ बैठता है
साफ़ शब्दों में: प्लेटफ़ॉर्म फ्लाइट और होटल API देता है, और पहुँच सेल्फ़-सर्व कुंजी से नहीं, बातचीत से शुरू होती है। सेवाएँ हर टेनेंट के लिए चालू की जाती हैं, इसलिए जो टेनेंट होटल बेचता है और टूर नहीं, वह टूर वाला हिस्सा नहीं ढोता। यहाँ ऐसे किसी एक कॉल का वादा नहीं है जो दोनों हिस्से परमाणु रूप से बुक कर दे, और आपको ऐसे डिज़ाइन नहीं करना चाहिए मानो वह हो। उन्हें दो बुकिंग की तरह लें, ऐसी यात्रा के नीचे जिसके मालिक आप हैं।
अगर उनके इर्द-गिर्द बनाने से पहले असली कॉल और शर्तें देखना चाहते हैं, तो ट्रैवल API पेज से शुरू करें और वह क्रम साथ लाएँ जिसमें आप बुक करना चाहते हैं। अगर आप अभी यह तय कर रहे हैं कि मुफ़्त पहुँच से क्या मिलता है, तो मुफ़्त होटल बुकिंग API में मुफ़्त के प्रकार बताए गए हैं।
ग़लत करने की क़ीमत
महँगा संस्करण चुपचाप वाला है। ग्राहक का शहर का टिकट कट चुका है और कमरा जा चुका है, और आपको पहली ख़बर रात में एयरपोर्ट से आए संदेश से मिलती है। सस्ते पर फिर भी असली: ऐसा चेकआउट जो एक तसल्ली देने वाली कुल राशि दिखाए और कीमत जाँच के बाद दूसरा आँकड़ा, जिस पर ग्राहक राज़ी नहीं था; ऐसा रिफ़ंड जो फ्लाइट लौटाए और होटल भूल जाए; और ऐसी स्थिति जो "बुक्ड" कहे जबकि सप्लायर कुछ और कहता है।
इनमें से किसी को चतुर हल नहीं चाहिए। इसे चाहिए कि यात्रा एक असली वस्तु हो, क्रम ऐसा फ़ैसला हो जो किसी ने लिखा हो, और दोनों में से किसी के कमिट होने से ठीक पहले आख़िरी क्षण में दोनों कीमतों की दोबारा जाँच हो। इसे एक बार बना लें, तो चेकआउट उतना सरल दिख सकता है जितना टिकट ने माँगा था।