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

दुबई में API इंटीग्रेशन कंपनी रखने से पहले

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

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

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

यह लेख उस मालिक के लिए है जो स्टेटमेंट ऑफ़ वर्क पर दस्तख़त करेगा, उस डेवलपर के लिए नहीं जो उसे पढ़ेगा।

दुबई में API इंटीग्रेशन कंपनी क्या दे सकती है और क्या नहीं

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

जो वह आपको नहीं दे सकती, वह है उस कोड के दूसरी तरफ़ की हर चीज़। एक भी लाइन लिखे जाने से पहले एजेंसी को चाहिए:

  • एजेंसी के अपने नाम पर सप्लायर अकाउंट, जिसमें API एक्सेस उसी अकाउंट को दिया गया हो;
  • टिकट जारी करने का अधिकार — अपनी मान्यता, या कोई consolidator जो आपकी ओर से टिकट जारी करे;
  • उस सप्लायर के साथ पैसे का इंतज़ाम: डिपॉज़िट, क्रेडिट लाइन, या कार्ड भुगतान सीधे आगे भेजना;
  • कोई जो टिकट के बाद का काम करे (void, रिफ़ंड, री-इश्यू, शेड्यूल बदलाव), API से, और न हो सके तो हाथ से।

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

ब्रीफ़: स्टेटमेंट ऑफ़ वर्क के लिए सात बातें

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

  1. सप्लायर अकाउंट और API keys किसके नाम पर हैं। एजेंसी के। Keys लॉगिन जैसी गोपनीय जानकारी हैं: वे आपके पासवर्ड वॉल्ट में रहती हैं, और इंटीग्रेटर को एक्सेस मिलता है, मालिकाना हक़ नहीं।
  2. साइट कौन होस्ट करता है और डोमेन किसके पास है। डोमेन एजेंसी के नाम पर रजिस्टर्ड है। होस्टिंग अकाउंट एजेंसी का है, या अनुबंध में साफ़ लिखा है कि वह कैसे सौंपा जाएगा।
  3. कौन-से ऑपरेशन स्कोप में हैं। उन्हें नाम से लिखें: सर्च, कीमत, बुकिंग, टिकटिंग, कैंसिल, रिफ़ंड, बदलाव। जो सूची में नहीं है, वह साइट की पूरी उम्र सप्लायर की डेस्क को भेजा जाने वाला ईमेल ही रहेगा। सबसे ज़्यादा रिफ़ंड और बदलाव छूटते हैं, क्योंकि कोई डेमो उन्हें कभी नहीं दिखाता।
  4. सप्लायर के API बदलने पर रखरखाव कौन करेगा। सप्लायर पुराने वर्ज़न बंद करते हैं और फ़ील्ड के नाम बदलते हैं। बिना मेंटेनेंस क्लॉज़ वाला फ़िक्स्ड-प्राइस काम उसी दिन ख़त्म हो जाता है जिस दिन पहला वर्ज़न बदलता है।
  5. हैंडओवर का मतलब क्या है। एजेंसी के अपने रिपॉज़िटरी में सोर्स कोड, हर क्रेडेंशियल, और एक दस्तावेज़ जिससे कोई दूसरा डेवलपर काम आगे बढ़ा सके। "हम आपको zip भेज देंगे" हैंडओवर नहीं है।
  6. लाइव होना कैसे साबित होगा। सप्लायर के टेस्ट एनवायरनमेंट में सर्च से टिकट तक एक टेस्ट बुकिंग, कैंसिलेशन समेत — किसी असली ग्राहक का कार्ड चार्ज होने से पहले।
  7. ग्राहकों के डेटा का क्या होगा। यात्रियों के नाम, पासपोर्ट विवरण और भुगतान संदर्भ: कहाँ रखे जाते हैं, कौन पढ़ सकता है, और कैसे मिटाए जाते हैं।

इनमें से किसी के लिए तकनीकी पृष्ठभूमि नहीं चाहिए। हर बात काम शुरू होने से पहले तय कर लेना, बाद में मोलभाव करने से सस्ता पड़ता है।

सप्लायर का कंटेंट अपनी साइट पर लाने के तीन तरीके

किसी सप्लायर के API पर इंटीग्रेटर रखना एक रास्ता है। कोई कोटेशन आपके लिए फ़ैसला करे, उससे पहले इसे बाकी दो रास्तों के साथ रखकर देखना ठीक है।

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

बहस के लायक पंक्ति पहली है। यह सबसे ज़्यादा नियंत्रण देती है और सबसे ज़्यादा बोझ भी आप पर डालती है: सप्लायर का हर बदलाव, हर नई सेवा और पहले वर्ज़न में छूटा हर ऑपरेशन एक और प्रोजेक्ट बन जाता है, एक और कोटेशन के साथ।

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

यह प्लेटफ़ॉर्म कहाँ आता है

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

अगर आपकी तरफ़ का काम कोई इंटीग्रेशन कंपनी बनाएगी, तो कोटेशन स्वीकार करने से पहले यह बातचीत कर लें, ताकि स्कोप उसी API का वर्णन करे जिससे वह असल में जुड़ेगी। शुरुआत ट्रैवल API पेज से होती है।

कमज़ोर ब्रीफ़ की कीमत

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

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

या इंटीग्रेटर बस कहीं और व्यस्त है। किसी ग्राहक को टिकट पर नाम ठीक करवाना है, बदलाव वाला ऑपरेशन कभी स्कोप में था ही नहीं, और आपके दो कर्मचारी पूरी दोपहर सप्लायर की डेस्क को ईमेल करते रहते हैं। ठीक वही काम जो साइट को हटाना था।

इनमें से हर मामला ब्रीफ़ में छूटा हुआ एक वाक्य है। कोड हर बार ठीक था।

Tekravel संपादकीय

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

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