مواد پر جائیں
بلاگ

فلائٹ بکنگ API انٹیگریشن: جو ڈاکس نہیں بتاتیں

Tekravel اداریہ
AI کی مدد سے لکھا گیا

آپ کے بورڈ پر ٹکٹ میں بس اتنا لکھا ہے: "فلائٹس شامل کریں"۔ اگر آپ پیمنٹس، شپنگ ریٹس اور شاید نقشوں کی انٹیگریشن پہلے کر چکے ہیں تو فلائٹ بکنگ API انٹیگریشن کے بارے میں ذہن میں وہی سیدھا خاکہ ہوتا ہے: سرچ، نتائج دکھائیں، کارڈ سے رقم لیں، کام ختم۔ پھر پہلی اصل بکنگ نتائج والے صفحے سے مختلف قیمت پر واپس آتی ہے، دوسری ٹائم آؤٹ ہو جاتی ہے اور کوئی نہیں بتا سکتا کہ گاہک کی سیٹ بک ہوئی یا نہیں، اور آپریشنز سے کوئی پوچھتا ہے کہ ریزرویشن تو موجود ہے مگر ٹکٹ کیوں نہیں۔ باہر سے یہ کسی ای کامرس چیک آؤٹ جیسا لگتا ہے۔ اندر سے یہ ان سسٹمز کے ساتھ ایک ڈسٹری بیوٹڈ ٹرانزیکشن ہے جو REST سے بہت پہلے بنائے گئے تھے، اور زیادہ تر حیرتیں اسی خلا سے جنم لیتی ہیں۔

یہ تحریر اس ڈویلپر کے لیے ہے جس نے کبھی PNR نہیں دیکھا۔ یہ کسی ایک سپلائر کے اینڈ پوائنٹس کے بارے میں نہیں؛ نام ہر فراہم کنندہ کے ہاں بدل جاتے ہیں، ڈھانچہ نہیں بدلتا۔

فلائٹ بکنگ API انٹیگریشن کے پیچھے کالز کی ترتیب

تقریباً ہر فلائٹ API، اپنے میتھڈز کو جو بھی نام دے، انہی چار مراحل سے گزرتا ہے۔ ان کے درمیان حدیں درست کھینچنا ہی کام کا بڑا حصہ ہے۔

مرحلہیہ آپ کو کیا دیتا ہےآپ کو کیا محفوظ کرنا ہےکیا غلط ہوتا ہے
سرچقیمت کے ساتھ سفری روٹس اور ایک مبہم آفر یا فیئر کی (key)کوئی پائیدار چیز نہیں — نتائج جلد پرانے ہو جاتے ہیںآپ قیمت کو حتمی سمجھ لیتے ہیں؛ چیک آؤٹ سے پہلے کی ایکسپائر ہو جاتی ہے
پرائس / تصدیقتصدیق شدہ قیمت، فیئر رولز، بیگیج، اور بعض اوقات مسافر کے لازمی فیلڈزتصدیق شدہ آفر اور اس کی میعادقیمت بدل گئی؛ کلاس فروخت ہو کر ختم ہو گئی؛ رولز وہ نہیں جو آپ نے دکھائے تھے
بکنگایک ریزرویشن — یعنی PNR — ریکارڈ لوکیٹر اور ٹکٹنگ کی آخری مہلت کے ساتھآپ کا اپنا ریفرنس، لوکیٹر، آخری مہلت، اور مسافروں کا بالکل وہی ڈیٹا جو بھیجا گیاجواب کے بغیر ٹائم آؤٹ؛ دہرے PNR؛ نام مسترد
ٹکٹنگجاری شدہ ای ٹکٹ نمبر؛ رقم دراصل یہیں پکی ہوتی ہےہر ٹکٹ نمبر، اسی مسافر اور سیگمنٹ کے ساتھ جس کا وہ ہےجزوی اجرا؛ مہلت گزرنے پر ایئرلائن کی طرف سے ریزرویشن منسوخ

جس قطار پر لوگ بحث کرتے ہیں وہ تیسری ہے، کیونکہ کئی API ایک ہی کال میں بکنگ اور ٹکٹنگ کی سہولت دیتے ہیں۔ چاہیں تو اسے استعمال کریں۔ ایئرلائن کی دنیا میں یہ دونوں پھر بھی الگ چیزیں ہیں: PNR ٹکٹ کے بغیر موجود رہ سکتا ہے، اور PNR بن جانے کے بعد ٹکٹ ناکام ہو سکتا ہے۔ مشترکہ اینڈ پوائنٹ صرف اس لمحے کو چھپا دیتا ہے جب ایک کام ہو گیا اور دوسرا نہیں ہوا، اس لیے آپ کے ڈیٹا ماڈل میں اس حالت کی جگہ پھر بھی ہونی چاہیے۔

یہ بھی دیکھیے کہ سرچ کیا واپس نہیں کرتا: کوئی وعدہ۔ وہ محض ایک اشتہار ہے۔ پرائس کا مرحلہ کوٹیشن ہے، اور سودا صرف ٹکٹ ہے۔

سرچ والی قیمت بکنگ والی قیمت کیوں نہیں ہوتی

ویب ڈویلپر کیٹلاگ کی توقع رکھتے ہیں۔ ایئرلائن کی انوینٹری کیٹلاگ نہیں ہے۔ ایک پرواز بکنگ کلاسز میں بکتی ہے، ہر کلاس ایک مخصوص فیئر پر سیٹوں کی ایک ٹوکری ہے، اور جیسے جیسے پرواز بھرتی ہے ایئرلائن یہ ٹوکریاں مسلسل کھولتی اور بند کرتی رہتی ہے۔ سرچ کے نتائج اس دستیابی سے جلدی میں جوڑے جاتے ہیں جو شاید پہلے ہی کچھ پیچھے ہو؛ جب تک صارف دو پاسپورٹس کی تفصیل ٹائپ کرتا ہے، اس پرواز کی سب سے سستی ٹوکری بند ہو چکی ہو سکتی ہے۔ پرائس کا مرحلہ چلتا ہے تو دوبارہ پوچھتا ہے، اور سچا جواب بعض اوقات زیادہ ہوتا ہے۔

ٹیکس اپنا الگ فرق ڈالتے ہیں۔ پرائسنگ کے وقت ان کا حساب انہی مسافروں اور اسی روٹ کے لیے دوبارہ ہوتا ہے، اور بچے یا شیرخوار کی قیمت اس بالغ سے مختلف ہوتی ہے جو سرچ نے فرض کیا تھا۔ اگر آپ کا اسٹور فرنٹ اس کرنسی کے علاوہ کوئی اور کرنسی دکھاتا ہے جس میں سپلائر قیمت دیتا ہے، تو کرنسی کی تبدیلی ایک اور جگہ ہے جہاں رقم ہلتی ہے۔

ڈیزائن کا نتیجہ سادہ ہے اور اکثر نظر انداز ہو جاتا ہے: سرچ والی قیمت پر کبھی چارج نہ کریں۔ ادائیگی سے پہلے پرائس کا مرحلہ چلائیں، موازنہ کریں، اور اگر رقم بدل گئی ہو تو نئی رقم دکھا کر گاہک سے پوچھیں۔ جو بھی مارک اپ آپ لگاتے ہیں اس کا حساب نئی قیمت پر دوبارہ ہونا چاہیے، نتائج والے صفحے سے اٹھا کر آگے نہیں لانا چاہیے — یہ وہی منطق ہے جس سے کوئی ایجنسی آن لائن مارک اپ کی حکمت عملی طے کرتے وقت گزرتی ہے، اور جب بنیادی قیمت نیچے سے سرک جائے تو یہ بھی اسی طرح ٹوٹتی ہے۔

idempotency اور بکنگ کے دوران ٹائم آؤٹ کا اصل مطلب

یہ حصہ دو بار پڑھنے والا ہے۔

جب بکنگ کال ٹائم آؤٹ ہوتی ہے تو آپ نہیں جانتے کہ کیا ہوا۔ ہو سکتا ہے درخواست پہنچی ہی نہ ہو۔ ہو سکتا ہے پہنچی ہو اور ناکام ہو گئی ہو۔ یا — وہ صورت جو تکلیف دیتی ہے — درخواست پہنچی، سپلائر نے ایئرلائن کے ہاں PNR بنا دیا، اور جواب آپ تک واپس آتے ہوئے راستے میں گم ہو گیا۔ آپ کے کوڈ کے لیے تینوں صورتیں بالکل ایک جیسی ہیں۔ ایئرلائن کے لیے تیسری صورت ایک زندہ ریزرویشن ہے جو آپ کے گاہک کے نام پر سیٹیں روکے ہوئے ہے۔

دوسری انٹیگریشنز سے آنے والی عادت ہے دوبارہ کوشش، یعنی retry۔ یہاں اندھا دھند retry انہی مسافروں کے لیے اسی پرواز پر دوسرا PNR بنا سکتا ہے۔ ایئرلائنز دہری بکنگ کو پالیسی کی خلاف ورزی سمجھتی ہیں؛ کیریئر اور ایجنسی کے معاہدوں کے لحاظ سے نتیجہ ایک یا دونوں ریزرویشنز کی خودکار منسوخی سے لے کر ڈیبٹ میمو — یعنی ADM — تک ہو سکتا ہے جو ٹکٹ جاری کرنے والے کو بھیجا جاتا ہے۔ جس ایجنسی کو یہ ملے گا وہ جاننا چاہے گی کہ آپ کے سسٹم نے دو بار بکنگ کیوں کی۔

جو طریقہ کام کرتا ہے، تقریباً اسی ترتیب سے:

  • باہر کال کرنے سے پہلے اپنا بکنگ ریفرنس بنائیں، اسے محفوظ کریں، اور جہاں بھی API کلائنٹ ریفرنس قبول کرتا ہو اسے درخواست کے ساتھ بھیجیں۔ اگر API دہرائی گئی درخواست کو ایک ہی بار ماننے والی کلید (idempotency key) کو سپورٹ کرتا ہے تو اسے استعمال کریں؛ اگر نہیں کرتا، تب بھی آپ کا ریفرنس ہی بعد میں بکنگ ڈھونڈنے کا ذریعہ ہے۔
  • نامعلوم حالت کو واضح طور پر ماڈل کریں۔ زیرِ التوا، تصدیق شدہ، ناکام — اور نامعلوم۔ ٹائم آؤٹ بکنگ کو نامعلوم میں لے جاتا ہے، ناکام میں نہیں۔
  • نامعلوم کو دہرا کر نہیں، پوچھ کر حل کریں۔ دوبارہ کوشش کا فیصلہ کرنے سے پہلے اپنے ریفرنس سے بکنگ نکالیں، یا ان مسافروں کی حالیہ بکنگز کی فہرست منگوائیں۔
  • ایک ری کنسیلی ایشن جاب چلائیں جو ہر اس بکنگ کو سمیٹے جو ابھی تک نامعلوم ہے اور اس کا سپلائر کی رپورٹ سے موازنہ کرے، اور جو معاملہ وہ طے نہ کر سکے اسے اندازے لگانے کے بجائے کسی انسان کی قطار میں بھیج دے۔

ٹکٹنگ کے ٹائم آؤٹ بھی یہی مسئلہ ہیں، بس اس میں پیسہ بھی جڑا ہے۔ اگر آپ ٹکٹنگ سے پہلے کارڈ سے رقم وصول (capture) کر لیں اور ٹکٹنگ اٹک جائے تو آپ کے پاس ادائیگی کر چکا گاہک ہے اور شاید ٹکٹ نہیں۔ اگر ٹکٹ پہلے جاری کریں اور capture ناکام ہو جائے تو آپ نے ایسی دستاویز جاری کر دی جس کی رقم کسی کو ایئرلائن کو ادا کرنی ہے۔ عام طریقہ یہ ہے کہ پہلے کارڈ کی منظوری (authorisation) لیں، پھر ٹکٹ جاری کریں، اور کامیابی پر capture کریں — اصل بات یہ ہے کہ یہ فیصلہ سوچ سمجھ کر کیا جائے، پروڈکشن میں جا کر دریافت نہ ہو۔

ٹریول کے وہ تصورات جو ویب ڈویلپرز کو حیران کرتے ہیں

ان میں سے کوئی بھی مشکل نہیں۔ ہر ایک نے کسی نہ کسی کا پورا ہفتہ ضائع کیا ہے، صرف اس لیے کہ اسے معلوم ہی نہیں تھا کہ یہ چیز موجود ہے۔

PNR ٹکٹ نہیں ہے

PNR ریزرویشن کا ریکارڈ ہے: مسافر، سیگمنٹس، رابطے، ایک آخری مہلت۔ ٹکٹ وہ ادا شدہ دستاویز ہے جو مسافر کو پرواز کا حق دیتی ہے۔ بغیر ٹکٹ کا PNR اپنی ٹکٹنگ مہلت پر ختم ہو جاتا ہے اور سیٹیں دوبارہ فروخت کے لیے کھل جاتی ہیں، بعض اوقات آپ کو خبر ہوئے بغیر۔

نام تقریباً ناقابلِ تبدیل ہیں

ٹکٹنگ کے بعد زیادہ تر فیئرز معمولی درستی سے آگے نام بدلنے کی اجازت نہیں دیتے، اور معمولی کسے کہا جائے اس کے اصول ہر ایئرلائن کے الگ ہیں۔ نام سفری دستاویز سے مطابقت رکھنا چاہیے۔ خاندانی نام اور پہلا نام الگ الگ لیں، فری ٹیکسٹ القاب کو نام کے فیلڈ میں نہ گھسنے دیں، اور توثیق بکنگ کال سے پہلے کریں، بعد میں نہیں۔

مسافر کی قسم سجاوٹ نہیں، قیمت کا حصہ ہے

بالغ، بچہ اور شیرخوار فیئر کی اقسام ہیں، اور کون سی قسم لاگو ہوگی اس کا فیصلہ عموماً سفر کی تاریخ پر عمر سے ہوتا ہے، بکنگ کی تاریخ پر نہیں۔ گود میں بیٹھنے والا شیرخوار عموماً کوئی سیٹ نہیں لیتا اور صرف کسی بالغ کے ساتھ سفر کر سکتا ہے۔ قسم غلط ہو تو پرائس کا مرحلہ یا تو ناکام ہوگا یا غلط فیئر بتائے گا۔

اوقات مقامی ہیں، اور سیگمنٹ لیگ نہیں

روانگی اور آمد کے اوقات ہر ہوائی اڈے کے مقامی وقت میں دیے جاتے ہیں۔ انہیں دکھانے کے لیے صارف کے ٹائم زون میں تبدیل نہ کریں، اور آفسیٹ کے بغیر ایک کو دوسرے سے گھٹا کر دورانیہ نہ نکالیں۔ ایک سفر میں سیگمنٹس ہوتے ہیں؛ تکنیکی اسٹاپ والے سیگمنٹ میں ایک سے زیادہ لیگ ہوتی ہیں۔ آپ کے UI اور ڈیٹا کو اس پر متفق ہونا چاہیے کہ "اسٹاپ" ان میں سے کس کو کہا جائے۔

فروخت کے بعد بھی بہت کچھ ہوتا ہے

ایئرلائنز ٹکٹ جاری ہونے کے بعد شیڈول بدلتی ہیں۔ جو بکنگ ٹکٹنگ کے وقت درست تھی وہ ہفتوں بعد نیا وقت، نیا فلائٹ نمبر یا ٹوٹا ہوا کنکشن دکھا سکتی ہے، اور سپلائر کے لحاظ سے آپ کو اس کا پتا کسی نوٹیفکیشن، کسی queue یا بکنگ دوبارہ نکالنے سے چلتا ہے۔ یہ مان کر چلیں کہ آپ کے نظر ہٹانے کے بعد بھی بکنگ بدل سکتی ہے۔

Void اور ریفنڈ ایک چیز نہیں

اجرا کے کچھ ہی دیر بعد عموماً ایک وقفہ ہوتا ہے جس میں ٹکٹ کو void کیا جا سکتا ہے، گویا وہ کبھی جاری ہی نہیں ہوا۔ اس وقفے کے بعد صرف فیئر رولز کے تحت ریفنڈ ممکن ہے، جس پر جرمانہ لگ سکتا ہے یا کچھ بھی واپس نہ ملے۔ یہ وقفہ اور اس کے اصول سپلائر اور اجرا کے معاہدے کے ہیں؛ "منسوخ کریں" کا بٹن بنانے سے پہلے انہیں پڑھ لیں۔

غلطی کتنی مہنگی پڑتی ہے

فلائٹ انٹیگریشن کی ناکامیاں ایک خاص انداز میں مہنگی پڑتی ہیں: وہ لاگز پر نہیں، لوگوں پر گرتی ہیں۔ دہری بکنگ ایئرلائن کو فون کال بن جاتی ہے اور شاید ایجنسی کے اکاؤنٹ کے خلاف میمو بھی۔ جس گاہک سے رقم لی گئی مگر ٹکٹ نہیں ملا، وہ ریفنڈ، شکایت اور چارج بیک کا خطرہ بن جاتا ہے۔ کامیاب ادائیگی کے بغیر جاری ہونے والا ٹکٹ ایئرلائن کا قرض بن جاتا ہے جو کسی کو چکانا ہے۔ جس شیڈول تبدیلی پر کسی نے کارروائی نہیں کی، وہ ایک ایسا مسافر بن جاتی ہے جو ایئرپورٹ پر اس پرواز کے لیے کھڑا ہے جو پہلے ہی جا چکی۔

ان میں سے کوئی بھی صورت سیدھے راستے (happy path) کے ٹیسٹ میں سامنے نہیں آتی۔ ناخوشگوار راستے پہلے لکھیں: بکنگ کے دوران ٹائم آؤٹ، بڑھ جانے والی قیمت، PNR کے بعد ناکام ہونے والا ٹکٹ، کامیاب ادائیگی کے بعد void۔ اگر یہ سنبھل گئے تو سیدھا راستہ آسان حصہ ہے۔

فلائٹ API کے ساتھ ٹیسٹنگ

سپلائرز کے ٹیسٹ ماحول مفید ہیں مگر نامکمل۔ وہ عموماً پروڈکشن سے پرسکون ہوتے ہیں، اس لیے فروخت شدہ کلاسز اور قیمتوں کی تبدیلی کم دیکھنے کو ملتی ہے، اور کچھ تو ٹائم آؤٹ کی نقل کرتے ہی نہیں۔ انہیں کالز کے ڈھانچے اور توثیقی غلطیوں کے لیے استعمال کریں، پھر پروڈکشن میں ایک کنٹرولڈ رن کی منصوبہ بندی کریں جس میں اصل بکنگز ہوں جنہیں آپ مقررہ وقفے کے اندر void کر دیں — اور آپریشنز ٹیم کو معلوم ہو کہ آپ یہ کر رہے ہیں۔

انٹیگریشن کرنی بھی ہے یا نہیں، یہ الگ سوال ہے۔ اگر آپ کو دراصل اپنے سسٹم میں خام انوینٹری کے بجائے ایک اسٹور فرنٹ چاہیے تو اس کا موازنہ وائٹ لیبل بمقابلہ اپنا بکنگ انجن بنانے میں تفصیل سے موجود ہے، اور یہی استدلال سب ایجنٹس کے لیے B2B پورٹل پر بھی لاگو ہوتا ہے۔ اگر آپ واقعی انوینٹری اپنے کوڈ میں چاہتے ہیں تو یہ پلیٹ فارم فلائٹ اور ہوٹل API فراہم کرتا ہے، اور رسائی کسی سیلف سروس کی سے نہیں بلکہ آپ کے استعمال کے مقصد پر بات چیت سے شروع ہوتی ہے — اور یہی اوپر کا ہر سوال پوچھنے کا صحیح موقع بھی ہے۔

Tekravel اداریہ

ٹریول ٹیکنالوجی ڈیسک

Tekravel کا ٹریول ٹیکنالوجی ڈیسک پیشہ ور افراد کے لیے لکھتا ہے: ایجنسی مالکان، کنسولیڈیٹرز اور وہ ڈویلپرز جو انہیں مربوط کرتے ہیں۔ ہر مضمون شائع ہونے سے پہلے اُسی پلیٹ فارم پر جانچا جاتا ہے جس کا وہ ذکر کرتا ہے۔