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

फ़्लाइट बुकिंग API इंटीग्रेशन: डॉक्स जो नहीं बताते

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

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

यह लेख उस डेवलपर के लिए है जिसने कभी PNR नहीं देखा। यह किसी एक सप्लायर के एंडपॉइंट्स के बारे में नहीं है; नाम हर प्रोवाइडर के साथ बदलते हैं, ढाँचा नहीं बदलता।

फ़्लाइट बुकिंग API इंटीग्रेशन में कॉल का क्रम

लगभग हर फ़्लाइट API, चाहे अपने मेथड्स को जो भी नाम दे, यही चार क़दम चलता है। इनके बीच की सीमाएँ सही खींचना ही ज़्यादातर काम है।

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

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

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

सर्च की क़ीमत बुकिंग की क़ीमत क्यों नहीं होती

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

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

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

Idempotency, और बुकिंग के दौरान टाइमआउट का मतलब

यह हिस्सा दो बार पढ़िए।

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

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

जो काम करता है, मोटे तौर पर इस क्रम में:

  • बाहर कॉल करने से पहले अपना बुकिंग रेफ़रेंस बनाइए, उसे सहेजिए, और जहाँ भी API क्लाइंट रेफ़रेंस लेता है, रिक्वेस्ट के साथ भेजिए। API idempotency key सपोर्ट करता हो तो उसका इस्तेमाल करें; न करता हो, तब भी बाद में बुकिंग ढूँढने का ज़रिया आपका रेफ़रेंस ही है।
  • अज्ञात स्थिति को साफ़-साफ़ मॉडल कीजिए। पेंडिंग, कन्फ़र्म्ड, फ़ेल्ड — और अज्ञात। टाइमआउट बुकिंग को "अज्ञात" में ले जाता है, "फ़ेल्ड" में नहीं।
  • अज्ञात को दोहराकर नहीं, पूछकर सुलझाइए। दोबारा कोशिश का फ़ैसला करने से पहले अपने रेफ़रेंस से बुकिंग निकालिए, या उन यात्रियों की हाल की बुकिंग्स की सूची देखिए।
  • एक रिकंसिलिएशन जॉब चलाइए जो हर अब तक अज्ञात चीज़ को सप्लायर की रिपोर्ट से मिलाए, और जो ख़ुद तय न कर सके उसे अंदाज़ा लगाने के बजाय इंसानी क़तार में भेजे।

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

ट्रैवल की वे धारणाएँ जो वेब डेवलपर्स को चौंकाती हैं

इनमें से कोई कठिन नहीं है। हर एक ने किसी न किसी का एक हफ़्ता खाया है, क्योंकि उसे पता ही नहीं था कि यह मौजूद है।

PNR टिकट नहीं है

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

नाम लगभग बदले नहीं जा सकते

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

यात्री का प्रकार क़ीमत है, सजावट नहीं

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

समय स्थानीय है, और सेगमेंट लेग नहीं है

प्रस्थान और आगमन का समय हर एयरपोर्ट के स्थानीय समय में दिया जाता है। दिखाते वक़्त इसे यूज़र के टाइम ज़ोन में मत बदलिए, और ऑफ़सेट के बिना घटाकर अवधि मत निकालिए। एक यात्रा में सेगमेंट होते हैं; तकनीकी ठहराव वाले सेगमेंट में एक से ज़्यादा लेग होते हैं। आपका UI और डेटा इस पर सहमत होने चाहिए कि "स्टॉप" इनमें से कौन-सा है।

बिक्री के बाद भी बहुत कुछ होता है

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

Void रिफ़ंड नहीं है

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

ग़लती की क़ीमत

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

इनमें से कुछ भी हैप्पी-पाथ टेस्ट में नहीं दिखता। पहले नाकामी वाले रास्ते लिखिए: बुकिंग के दौरान टाइमआउट, बढ़ी हुई क़ीमत, PNR के बाद फ़ेल हुआ टिकट, सफल भुगतान के बाद void। ये सँभल गए तो हैप्पी पाथ आसान हिस्सा है।

फ़्लाइट API के ख़िलाफ़ टेस्टिंग

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

इंटीग्रेट करना है या नहीं, यह अलग सवाल है। अगर आपको असल में अपने सिस्टम में कच्ची इन्वेंटरी नहीं, बल्कि एक स्टोरफ़्रंट चाहिए, तो यह तौल अपना बुकिंग इंजन या white label में समझाया गया है, और यही तर्क सब-एजेंट्स के लिए B2B पोर्टल पर भी लागू होता है। अगर इन्वेंटरी आपको अपने कोड में ही चाहिए, तो यह प्लेटफ़ॉर्म फ़्लाइट और होटल API देता है, और एक्सेस सेल्फ़-सर्व की से नहीं, आपके उपयोग-मामले पर बातचीत से शुरू होता है — ऊपर का हर सवाल पूछने का सही मौक़ा भी वही है।

Tekravel संपादकीय

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

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