ট্রাভেল API স্যান্ডবক্স টেস্টিং: যা চোখে পড়ে না

ট্রাভেল API স্যান্ডবক্স (sandbox) টেস্টিং যা কিছু ছুড়ে দিতে পারত, ইন্টিগ্রেশনটি তার সবই পার করে গিয়েছিল। সার্চে ফ্লাইট এসেছিল, হোটেলের অ্যাভেইলেবিলিটি কলে রুম ফিরে এসেছিল, বুকিং কল প্রতিবারই একটি কনফার্মেশন নম্বর দিয়েছিল, আর QA এক বৃহস্পতিবার সেটি অনুমোদন করে দিয়েছিল। পরের মঙ্গলবার একজন গ্রাহক একটি হোটেলের জন্য এক দামে টাকা দিলেন, অথচ সাপ্লায়ার সেটি কনফার্ম করল অন্য দামে; একটি ফ্লাইট বুকিং টাইমআউট হলো এবং কেউ বলতে পারল না সিট আদৌ হোল্ড হয়েছে কি না; আর একজন সাপোর্ট এজেন্ট পুরো একটা বিকেল কাটালেন একই ট্রিপের দুটি আলাদা রেকর্ড মেলাতে। এর কোনোটিই টেস্ট স্যুটের মিস করা কোনো বাগ ছিল না। এগুলো ছিল এমন পরিস্থিতি, যা দেখার কোনো উপায়ই টেস্ট স্যুটের কাছে ছিল না। স্যান্ডবক্স প্রয়োজনীয়, কিন্তু যথেষ্ট হওয়া থেকে অনেক দূরে, আর এই দুইয়ের মাঝের ফাঁকটাতেই একটি ট্রাভেল ইন্টিগ্রেশনের সবচেয়ে ব্যয়বহুল ঘটনাগুলোর বেশিরভাগ ঘটে।
এটি সেই ডেভেলপারের জন্য একটি টেস্ট পরিকল্পনা, যিনি ওই ইন্টিগ্রেশনের দায়িত্বে আছেন: স্যান্ডবক্স কী প্রমাণ করতে পারে, কাঠামোগতভাবেই কী পারে না, আর কোম্পানির কার্ডে আসল সিট বুক না করেও সেই পার্থক্য কীভাবে পূরণ করা যায়।
ট্রাভেল API স্যান্ডবক্স টেস্টিং পার করা কোড কেন প্রোডাকশনে ভেঙে পড়ে
স্যান্ডবক্স রেসপন্সের আকার নিয়ে একটি প্রতিশ্রুতি দেয়, তাদের আচরণ নিয়ে নয়। স্কিমা প্রোডাকশনের সঙ্গে মেলে। কিন্তু আচরণ প্রায় কখনোই মেলে না, এবং তার কারণগুলো কারও দোষ নয়: একটি টেস্ট এনভায়রনমেন্টের পক্ষে লাইভ ইনভেন্টরি চালানো সম্ভব নয়, তাই সে একটি নির্দিষ্ট সেট ফেয়ার আর রুম দেয়, যা কখনো সোল্ড আউট হয় না, যার দাম কখনো নতুন করে নির্ধারিত হয় না, যার সময়সূচি কখনো বদলায় না। অন্য কেউ ব্যবহার করছে না বলে সে দ্রুত উত্তর দেয়। মাঝপথে ব্যর্থ হওয়ার ঘটনাও তার ক্ষেত্রে বিরল।
প্রোডাকশনে এই সবকিছুই প্রতিদিন ঘটে। ইনভেন্টরি অন্য সব বিক্রেতার সঙ্গে ভাগ করা থাকে; ফেয়ার আপস্ট্রিমের কেউ ক্যাশ করে রাখে এবং সেটি পুরোনো হয়ে যায়; লোডের চাপে থাকা সাপ্লায়ারের সিস্টেম ধীরে উত্তর দেয় অথবা একেবারেই দেয় না। যে কোড কেবল স্যান্ডবক্সই দেখেছে, কার্যত তাকে শুধু এমন এক সাপ্লায়ারের বিরুদ্ধে টেস্ট করা হয়েছে যার দিনটা নিখুঁত যাচ্ছে।
তাই স্যান্ডবক্সকে তিনটি স্তরের একটি হিসেবে দেখুন। এটি প্রমাণ করে যে আপনার রিকোয়েস্টগুলো সঠিক ফরম্যাটে আছে এবং আপনার পার্সার স্কিমা বোঝে। রেকর্ড করা ফিক্সচার প্রমাণ করে যে প্রোডাকশন আসলে যে রেসপন্স পাঠায়, আপনার কোড সেগুলো সামলে টিকে থাকে। লাইভ চেকের একটি ছোট, সচেতনভাবে বাছাই করা সেট প্রমাণ করে যে কিছু বদলানোর পরও সংযোগগুলো ঠিক আছে। প্রতিটি স্তর এমন জিনিস ধরে, যা বাকি দুটি ধরতে পারে না।
যে পরিস্থিতিগুলো স্যান্ডবক্স সাধারণত আপনাকে দিতে পারে না
একটি টেস্টও লেখার আগে এগুলো লিখে ফেলুন। কোনো স্যান্ডবক্স হয়তো বিশেষ কোনো টেস্ট ভ্যালু দিয়ে এর এক-দুটি অনুকরণ করতে পারে; বেশিরভাগই তার কাছে একেবারেই নেই।
| পরিস্থিতি | প্রোডাকশন কী করে | কীভাবে কভার করবেন |
|---|---|---|
| সার্চ আর বুকিংয়ের মাঝে দাম বদলে যাওয়া | বুকিং কল ভিন্ন মোট দামে সফল হয়, অথবা এমন একটি দাম-পরিবর্তনের এররে ব্যর্থ হয় যা আপনাকে ব্যবহারকারীকে দেখাতেই হবে | ফিক্সচারের একটি জোড়া: একটি সার্চ রেসপন্স এবং ভিন্ন মোট দামের একটি বুকিং রেসপন্স; যাচাই করুন যে যাত্রীকে আবার জিজ্ঞেস করা হয়, কখনো নীরবে টাকা কাটা হয় না |
| অ্যাভেইলেবিলিটি আর বুকিংয়ের মাঝে সোল্ড আউট | যে রুম বা ফেয়ার ক্লাস দেখানো হয়েছিল, হোল্ড করতে গেলে দেখা যায় সেটি আর নেই | সাপ্লায়ারের আসল সোল্ড-আউট এররের ফিক্সচার; যাচাই করুন যে যাত্রী এরর পেজে নয়, রেজাল্টে ফিরে যান |
| বুকিং কলে টাইমআউট | সাপ্লায়ার হয়তো বুকিং তৈরি করেছে, হয়তো করেনি | রিকোয়েস্ট পাঠানোর পরে একটি টাইমআউট ইনজেক্ট করুন; যাচাই করুন যে কোনো রিট্রাইয়ের আগে আপনি বুকিংয়ের স্ট্যাটাস জিজ্ঞেস করেন |
| ডুপ্লিকেট সাবমিশন | একটি ডাবল-ক্লিক বা ক্লায়েন্টের রিট্রাই দুটি বুকিং তৈরি করে | একই idempotency key (একই অনুরোধ দুবার কার্যকর হওয়া ঠেকানোর চাবি) দিয়ে একই বুকিং দুবার পাঠান; যাচাই করুন যে ঠিক একটিই বুকিং আছে |
| টিকিটিংয়ের পরে সময়সূচি পরিবর্তন | যে ফ্লাইট আপনি বিক্রি করেছেন সেটি এখন অন্য সময়ে, বা অন্য ফ্লাইট নম্বরে ছাড়ে | পরিবর্তিত ইটিনেরারির ফিক্সচার; যাচাই করুন যে পরিবর্তনটি গ্রাহকের দায়িত্বে থাকা ব্যক্তির কাছে পৌঁছায় |
| একাধিক আইটেমের বুকিংয়ে আংশিক সাফল্য | ফ্লাইট কনফার্ম হয়, হোটেল হয় না | মিশ্র ফিক্সচার; যাচাই করুন যে সিস্টেম ঠিক যা কনফার্ম হয়েছে তা-ই রেকর্ড করে এবং একজন মানুষকে সতর্ক করে |
| লোডের চাপে থ্রটলিং | রেট-লিমিট রেসপন্স, তারপর ধীর উত্তর | রেকর্ড করা একটি থ্রটলিং রেসপন্স রিপ্লে করুন; যাচাই করুন ব্যাকঅফ কাজ করছে, এবং সার্চ এরর দেওয়ার বদলে শুধু ধীর হয়ে যায় |
নিজের স্ট্যাকের জন্য শেষ কলামের সঙ্গে আপনি হয়তো একমত হবেন না। ঠিক আছে। আসল কথা হলো, প্রতিটি সারির একজন দায়িত্বপ্রাপ্ত ব্যক্তি এবং একটি অ্যাসারশন থাকতে হবে, কারণ এর প্রত্যেকটিই একদিন না একদিন আপনার সঙ্গে ঘটবে।
বানানো রেসপন্স নয়, আসল রেসপন্স থেকে ফিক্সচার তৈরি করুন
একটি ট্রাভেল ইন্টিগ্রেশনে সবচেয়ে কাজের অভ্যাস হলো যে রেসপন্সগুলো আপনাকে চমকে দিয়েছে সেগুলো রেখে দেওয়া। হাতে লেখা মক ডেটা প্রতিফলিত করে আপনি যা ভাবেন একজন সাপ্লায়ার পাঠায়; রেকর্ড করা রেসপন্স প্রতিফলিত করে সে আসলে কী পাঠিয়েছিল — এর মধ্যে আছে সেই ফিল্ডগুলো যেগুলো খালি থাকে অথচ ডকুমেন্টেশন বলে কখনো খালি থাকে না, এমন মুদ্রায় দাম যা আপনি চাননি, আর সেই এরর যা সাকসেস স্ট্যাটাস নিয়ে আসে।
একটি রুটিন যা কাজ করে:
- সীমানায় রেকর্ড করুন। নন-প্রোডাকশন এনভায়রনমেন্টে সাপ্লায়ার কলগুলোর কাঁচা রিকোয়েস্ট ও রেসপন্স বডি লগ করুন, আর আপনার প্রাইভেসি নিয়ম অনুমতি দিলে প্রোডাকশনেও ট্রাফিকের একটি নমুনা অংশের জন্য তা করুন।
- রাখার আগে পরিষ্কার করুন। কোনো ফিক্সচার রিপোজিটরিতে ঢোকার আগে যাত্রীর নাম, পাসপোর্ট নম্বর, ইমেইল, ফোন নম্বর ও পেমেন্ট রেফারেন্স সরিয়ে ফেলতে হবে। এগুলোর জায়গায় স্পষ্টতই নকল মান বসান, যাতে কেউ কোনো ফিক্সচারকে আসল বুকিং বলে ভুল না করে।
- আচরণ অনুযায়ী ফিক্সচারের নাম দিন।
hotel-book-price-increased.jsonপরের ডেভেলপারকে বলে দেয় ফাইলটি কেন আছে;response-17.jsonকিছুই বলে না। - কুৎসিতগুলো চিরকাল রেখে দিন। যে বিকৃত রেসপন্স এক রবিবার সার্চ বন্ধ করে দিয়েছিল, সেটিই আপনার সবচেয়ে মূল্যবান ফাইল। তার জায়গা এমন একটি টেস্টে, যা প্রতিটি কমিটে চলে।
তারপর ওই ফিক্সচারগুলোর বিরুদ্ধে কন্ট্র্যাক্ট টেস্ট লিখুন: আপনার পার্সার, অভ্যন্তরীণ মডেলে আপনার ম্যাপিং, আপনার এরর শ্রেণিবিভাগ। কোনো সাপ্লায়ার একটি ফিল্ডের নাম বদলালে যদি একটি কন্ট্র্যাক্ট টেস্ট ব্যর্থ হয়, তাহলে আপনি সেটা জানবেন গ্রাহকের কাছ থেকে নয়, CI থেকে। এরর শ্রেণিবিভাগের দিকটি আরও বিস্তারিতভাবে আলোচনা করা হয়েছে বুকিং ইঞ্জিন API-এর এরর হ্যান্ডলিং নিয়ে আমাদের লেখায়।
টাকা খরচ না করে টাকার পথগুলো টেস্ট করা
এখানে স্যান্ডবক্স সবচেয়ে কম সাহায্য করে, কারণ টাকার পথগুলোতেই টেস্ট এনভায়রনমেন্ট আসলটির থেকে সবচেয়ে বেশি আলাদা। আসল টিকিটিং, আসল কার্ড ক্যাপচার আর আসল সাপ্লায়ার ইনভয়েসিং — এগুলোই আপনাকে সবচেয়ে নির্ভুলভাবে করতে হবে, অথচ লাইভে মহড়া দেওয়ার সুযোগ এগুলোরই সবচেয়ে কম।
সমস্যাটিকে ভাগ করুন। দামের হিসাব বিশুদ্ধ লজিক, তাই অফলাইনে পুরোপুরি টেস্ট করা যায়: রেকর্ড করা ফেয়ার নিন, আপনার মার্কআপ নিয়ম, মুদ্রা রূপান্তর ও রাউন্ডিং প্রয়োগ করুন, তারপর যাত্রী যে মোট দাম দেখেন তা যাচাই করুন। জটিল ক্ষেত্রগুলোর জন্যও এটি করুন — এক মুদ্রার ফেয়ার যা অন্য মুদ্রায় বিক্রি হয়, এমন মার্কআপ যা এক প্রোডাক্টে শতাংশ আর অন্যটিতে নির্দিষ্ট অঙ্ক, শিশুর ফেয়ার, এমন একটি রাউন্ডিং ধাপ যা প্রদর্শন আর চার্জের মধ্যে আলাদা। কয়েক একক মুদ্রায় ভুল একটি মোট দামও ভুলই, এবং সেটি প্রতিটি বুকিংয়েই ভুল।
পেমেন্টকে ঘিরে স্টেট ট্রানজিশনগুলো হলো দ্বিতীয় অর্ধেক। এগুলো স্পষ্টভাবে মডেল করুন — কোটেড, হোল্ড, পেইড, কনফার্মড, টিকিটেড, ক্যানসেলড, রিফান্ডেড — এবং টেস্ট করুন যে প্রতিটি ট্রানজিশনের ঠিক একটিই কারণ আছে। যে টেস্ট সবচেয়ে ব্যয়বহুল বাগটি ধরে, তা হলো সেটি, যা যাচাই করে যে সাপ্লায়ার কনফার্ম করেনি এমন বুকিংয়ের জন্য পেমেন্ট ক্যাপচার করা যায় না, এবং পেমেন্ট রেকর্ড ছাড়া কোনো কনফার্মড বুকিং থাকতে পারে না।
সবশেষে, কোনো টেস্ট রানের পক্ষে লাইভ টিকিটিংয়ে পৌঁছানো অসম্ভব করে দিন। অসম্ভাব্য নয়; অসম্ভব। প্রোডাকশনের ক্রেডেনশিয়াল লোড থাকলে স্যুট চালাতে অস্বীকার করে এমন একটি স্টার্ট-আপ চেকের খরচ মাত্র এক লাইন, আর এটি একটি ইন্টিগ্রেশন টিমের জীবনের সবচেয়ে খারাপ সকালটি ঠেকিয়ে দেয়।
ভুল করলে আপনাকে কী মূল্য দিতে হয়
ট্রাভেল ইন্টিগ্রেশনে বাদ পড়া কোনো পরিস্থিতি খুব কমই এরর হিসেবে দেখা দেয়। এটি দেখা দেয় এমন এক বুকিং হিসেবে, যা দেখতে একদম ঠিকঠাক। এমন একটি ডুপ্লিকেট টিকিট যা কেউ চায়নি, আর কাউকে ডেডলাইনের আগে সেটি ভয়েড করতে হবে। এমন দামে কনফার্ম হওয়া একটি হোটেল, যার ক্ষতি এখন এজেন্সিকেই বহন করতে হবে। টাইমআউট হওয়া একটি বুকিং যা সিস্টেম আবার চেষ্টা করেছে, ফলে সাপ্লায়ার দুটি রুম হোল্ড করে রেখেছে এবং দুটিরই ইনভয়েস করছে। কোনো এজেন্সির মাধ্যমে বিক্রি হওয়া এয়ারলাইন টিকিটের ক্ষেত্রে, যা ইস্যু হয়েছে আর যা বিক্রি হয়েছে তার মধ্যে অমিল পরে ADM হয়ে ফিরে আসতে পারে — ততদিনে ওই বিক্রির মার্জিন বহু আগেই খরচ হয়ে গেছে।
এই খরচগুলো পড়ে সেই ব্যবসার ঘাড়ে যারা ট্রিপটি বিক্রি করেছে, রিট্রাই লুপ লেখা ডেভেলপারের ঘাড়ে নয়। একটি একটি করে সাপোর্ট টিকিটের মাধ্যমে শেখার বদলে লঞ্চের আগেই এগুলো টেস্ট করার পক্ষে পুরো যুক্তিটা এটাই।
প্রতিবার সাপ্লায়ারের পরিবর্তনের পরে কী স্মোক-টেস্ট করবেন
সাপ্লায়াররা জিনিস বদলায়: নতুন API ভার্সন, নতুন এন্ডপয়েন্ট, বদলানো ক্রেডেনশিয়াল, ভিন্ন কনটেন্ট ম্যাপিং। আপনার নিজের কোড হয়তো একটুও বদলায়নি। তবুও, পরিবর্তিত সাপ্লায়ারের সঙ্গে যোগাযোগ করে এমন এনভায়রনমেন্টে এই তালিকাটি চালান:
- ওই সাপ্লায়ার থেকে আপনি যত প্রোডাক্ট বিক্রি করেন, প্রতিটির জন্য একটি করে সার্চ, এমন রুট বা শহরে যেখানে রেজাল্ট আসে বলে আপনি জানেন।
- কোনোটি নীরবে বাদ না দিয়ে প্রতিটি রেজাল্ট পার্স করুন; আপনার গণনা কাঁচা রেসপন্সে থাকা সংখ্যার সঙ্গে মিলিয়ে দেখুন।
- একটি রেজাল্টের দাম শুরু থেকে শেষ পর্যন্ত হিসাব করুন এবং প্রদর্শিত মোট দামকে কাঁচা ফেয়ার থেকে আপনার নিজের হিসাবের সঙ্গে তুলনা করুন।
- টেস্ট এনভায়রনমেন্টে একটি বুকিং করুন, তার স্ট্যাটাস আবার পড়ে আনুন এবং আপনি যে ফিল্ডগুলো সংরক্ষণ করেন তার প্রতিটি মিলিয়ে দেখুন।
- বুকিংটি বাতিল করুন এবং নিশ্চিত হোন যে বাতিলটি আপনার রেকর্ডে এবং সাপ্লায়ারের দিকে, দুই জায়গাতেই দেখা যাচ্ছে।
- সংরক্ষিত কুৎসিত ফিক্সচারগুলো নতুন পার্সারের মধ্য দিয়ে আবার চালান।
- পরীক্ষা করুন যে টাইমআউট আর রেট লিমিট এখনো আপনার ঠিক করা আচরণেই ম্যাপ হচ্ছে, কারণ নতুন ভার্সন এগুলোর উত্তর ভিন্নভাবে দিতে পারে। রেসপন্স টাইম বদলে গেলে, লেটেন্সি নিয়ে লেখাটি ব্যাখ্যা করে তার কোন অংশ ঠিক করা আপনার দায়িত্ব।
প্রতিবার চালানোর মতো যথেষ্ট ছোট, আর সেটাই মূল কথা। যে স্মোক টেস্ট একদিন লাগে বলে কেউ চালায় না, সেটি স্মোক টেস্টই নয়।
স্যান্ডবক্সের সঠিক জায়গা কোথায়
এর কোনোটিই স্যান্ডবক্সকে কম উপযোগী করে না। বরং এটি স্যান্ডবক্সকে তার সৎ জায়গায় বসায়: এমন জায়গা যেখানে আপনি স্কিমা শেখেন এবং রিকোয়েস্টগুলো সঠিক কি না নিশ্চিত করেন, তারপর ফিক্সচার আর লাইভ চেক সেই অংশগুলোর দায়িত্ব নেয় যেখানে স্যান্ডবক্স পৌঁছাতে পারে না। আপনি যদি প্ল্যাটফর্মের ফ্লাইট ও হোটেল API মূল্যায়ন করেন, তাহলে অ্যাক্সেস শুরু হয় একটি সেলফ-সার্ভ কী দিয়ে নয়, একটি আলোচনা দিয়ে — সেই আলোচনায় এই টেস্ট পরিকল্পনাটি নিয়ে আসুন এবং জিজ্ঞেস করুন ওপরের টেবিলের প্রতিটি সারি কীভাবে কভার করা হবে। সেই উত্তরগুলো একটি API সম্পর্কে তার ডকুমেন্টেশনের চেয়েও বেশি কিছু বলে দেবে।