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

ट्रैवल API सैंडबॉक्स टेस्टिंग: जो सैंडबॉक्स नहीं दिखाता

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

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

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

सैंडबॉक्स में पास कोड प्रोडक्शन में क्यों टूटता है

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

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

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

वे हालात जो सैंडबॉक्स आम तौर पर नहीं देता

पहला टेस्ट लिखने से पहले इन्हें लिख लीजिए। सैंडबॉक्स शायद किसी ख़ास टेस्ट वैल्यू से एक-दो की नकल कर दे; ज़्यादातर उसमें होते ही नहीं।

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

अपने स्टैक के हिसाब से आप आख़िरी कॉलम से असहमत हो सकते हैं। ठीक है। ज़रूरी यह है कि हर पंक्ति का एक मालिक और एक जाँच हो, क्योंकि इनमें से हर एक किसी न किसी दिन आपके साथ होगी।

फ़िक्स्चर असली जवाबों से बनाइए, गढ़े हुए से नहीं

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

एक तरीका जो काम करता है:

  • सीमा पर रिकॉर्ड करें। सप्लायर कॉल की कच्ची रिक्वेस्ट और जवाब नॉन-प्रोडक्शन में लॉग करें, और प्रोडक्शन में ट्रैफ़िक के एक नमूने के लिए, अगर आपके प्राइवेसी नियम इजाज़त दें।
  • रखने से पहले साफ़ करें। यात्रियों के नाम, पासपोर्ट नंबर, ईमेल, फ़ोन और भुगतान रेफ़रेंस फ़िक्स्चर के रिपॉज़िटरी में जाने से पहले हटा दें। उनकी जगह साफ़ तौर पर नकली वैल्यू रखें ताकि कोई फ़िक्स्चर को असली बुकिंग न समझे।
  • व्यवहार के हिसाब से नाम दें। hotel-book-price-increased.json अगले डेवलपर को बताता है कि यह फ़ाइल क्यों है; response-17.json कुछ नहीं बताता।
  • बदसूरत वाले हमेशा के लिए रखें। जिस बिगड़े जवाब ने एक रविवार सर्च ठप कर दी थी, वह आपकी सबसे क़ीमती फ़ाइल है। उसकी जगह ऐसे टेस्ट में है जो हर commit पर चलता है।

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

पैसे खर्च किए बिना पैसे वाले रास्ते टेस्ट करना

यहाँ सैंडबॉक्स सबसे कम मदद करता है, क्योंकि पैसे वाले रास्ते ठीक वहीं हैं जहाँ टेस्ट एनवायरनमेंट असली से अलग होता है। असली टिकटिंग, असली कार्ड कैप्चर और असली सप्लायर इनवॉइसिंग — इन्हें सबसे ज़्यादा सही होना चाहिए और इन्हीं का लाइव अभ्यास सबसे कम हो सकता है।

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

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

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

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

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

ये क़ीमतें उस कारोबार पर पड़ती हैं जिसने यात्रा बेची, उस डेवलपर पर नहीं जिसने retry लूप लिखा। लॉन्च से पहले इन्हें टेस्ट करने का पूरा तर्क यही है, बजाय इसके कि हर सपोर्ट टिकट से एक-एक करके सीखा जाए।

हर सप्लायर बदलाव के बाद स्मोक टेस्ट

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

  1. उस सप्लायर से बेचे जाने वाले हर प्रोडक्ट के लिए एक सर्च, ऐसे रूट या शहर पर जहाँ नतीजे पक्के आते हों, जैसे दिल्ली–दुबई।
  2. सारे नतीजे पार्स करें, कोई भी चुपचाप न छोड़ें; अपनी गिनती कच्चे जवाब से मिलाएँ।
  3. एक नतीजे की शुरू से आख़िर तक कीमत निकालें और दिखाई गई कुल रकम को कच्चे किराए से अपने हिसाब से मिलाएँ।
  4. टेस्ट एनवायरनमेंट में बुकिंग करें, उसका स्टेटस वापस पढ़ें और हर स्टोर किया गया फ़ील्ड मिलाएँ।
  5. उसे रद्द करें और पक्का करें कि रद्दीकरण आपके रिकॉर्ड और सप्लायर दोनों तरफ़ दिखे।
  6. सँभाले हुए बदसूरत फ़िक्स्चर नए पार्सर से दोबारा चलाएँ।
  7. जाँचें कि टाइमआउट और rate limit अब भी उसी व्यवहार पर ले जाते हैं जो आपने तय किया था, क्योंकि नया वर्ज़न इनका जवाब अलग दे सकता है। अगर जवाब का समय बदला है, तो लेटेंसी वाला लेख बताता है कि उसमें से कौन-सा हिस्सा आपके हाथ में है।

इतनी छोटी कि हर बार चलाई जा सके, और यही असली बात है। जो स्मोक टेस्ट एक दिन लेने की वजह से कोई नहीं चलाता, वह स्मोक टेस्ट नहीं है।

सैंडबॉक्स की सही जगह

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

Tekravel संपादकीय

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

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