फ्लाइट कीमतों की API: दिखने वाली संख्या अभी किराया क्यों नहीं है

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