ट्रैवल API तुलना: सप्लायर नहीं, धुरियों को परखें

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