ہوٹل اور فلائٹ بکنگ API: ایک سفر، دو بکنگ

ٹکٹ میں لکھا ہے: "فلائٹ کے بہاؤ میں ہوٹل شامل کریں، ایک چیک آؤٹ، ایک کل رقم۔" پروڈکٹ مینیجر کی طرف سے یہ مطالبہ معقول ہے اور ایک دن کا کام لگتا ہے، کیونکہ فلائٹ سرچ اور پیمنٹ پیج آپ کے پاس پہلے سے ہیں۔ تین ہفتے بعد ٹیم اس پر بحث کر رہی ہے کہ ایئر لائن نے تصدیق کر دی مگر ہوٹل نے نہیں کی تو کیا ہوگا۔ ہوٹل اور فلائٹ بکنگ API دو قسم کے نتائج والا ایک انٹیگریشن نہیں ہے۔ یہ ایک ٹوکری بانٹنے والے دو انٹیگریشن ہیں۔
کوڈ جتنی جلدی یہ مان لیتا ہے، اتنا کم حصہ دوبارہ لکھنا پڑتا ہے۔ آگے وہ حصہ ہے جو انٹیگریشن گائیڈ چھوڑ دیتی ہیں: دونوں حصے کیسے مختلف ہیں، پہلے کون سا کمٹ کریں، اور آپ کے ڈیٹا ماڈل میں سفر کو کیا ہونا چاہیے۔
دونوں حصے ایک جیسا برتاؤ نہیں کرتے
دونوں قیمت اور حوالہ نمبر کے ساتھ JSON میں آتے ہیں، اس لیے تار پر ایک جیسے دکھتے ہیں۔ حوالہ ملنے کے بعد جو وعدہ وہ کرتے ہیں، وہ ایک جیسا نہیں۔
| سوال | فلائٹ | ہوٹل |
|---|---|---|
| بکنگ کے بعد آپ کے پاس کیا ہے | ایک ریزرویشن (PNR) جو ابھی ٹکٹ نہیں | ایک تصدیق جو عموماً وہی چیز ہے جو آپ نے بیچی |
| قیمت کب تک درست ہے | بکنگ پر کرائے کی دوبارہ قیمت لگنے تک، جو سرچ سے مختلف ہو سکتی ہے | ریٹ کی میعاد ختم ہونے تک، اور ریٹ دستیابی اور بکنگ کے درمیان بدل سکتا ہے |
| تصدیق کیا کرتی ہے | ٹکٹنگ، اکثر وقت کی حد کے ساتھ | سپلائر کی تصدیق، کبھی فوری، کبھی زیر التوا |
| اسے کیسے واپس کریں | جلد پکڑا جائے تو void، ورنہ کرایہ کے قواعد کے تحت ریفنڈ، اکثر جرمانے کے ساتھ | ریٹ کی اپنی پالیسی کے تحت منسوخی، بہت سے ریٹس پر ایک کٹ آف تک مفت |
| بعد میں رقم کیا بدلتا ہے | کرایہ، ٹیکس، کبھی کرائے کی کرنسی | پراپرٹی پر ادا ہونے والے ٹیکس اور فیس، بورڈ بیسس، اصل میں دیا گیا کمرہ |
آپ کسی قطار سے اختلاف کر سکتے ہیں، کیونکہ سپلائر مختلف ہوتے ہیں، مگر اس کی شکل سے نہیں: ایک حصے میں ٹکٹنگ کا مرحلہ ہے اور دوسرے میں منسوخی کی کھڑکی، اور دونوں وقت میں ہم آہنگ نہیں ہوتے۔ ترتیب کے فلائٹ والے حصے پر ہم نے فلائٹ بکنگ API انٹیگریشن میں لکھا ہے، اور ہوٹل کی طرف سست سپلائر کے مسئلے پر ہوٹل دستیابی API کلائنٹ ڈیزائن میں۔ یہ تحریر وہاں سے شروع ہوتی ہے جہاں وہ ختم ہوتی ہیں، یعنی جوڑ پر۔
پہلے کون سا بک کریں؟
کوئی نہیں بتاتا کہ یہ ڈیزائن کا فیصلہ ہے، اور یہی طے کرتا ہے کہ ناکامی کی قیمت کیا ہوگی۔
فرض کریں گاہک ایک ہی تاریخوں کے لیے فلائٹ اور ہوٹل خریدتا ہے۔ آپ ایک بکنگ بھیجتے ہیں، پھر دوسری۔ تین چیزیں ہو سکتی ہیں: دونوں کامیاب ہوں، ایک ناکام ہو، یا ایک دوسری کے کامیاب ہونے کے بعد ناکام ہو۔ پہلی اچھا دن ہے۔ باقی دو آپ کی سپورٹ قطار طے کرتی ہیں۔
اگر آپ پہلے فلائٹ کا ٹکٹ جاری کر دیں اور ہوٹل بعد میں انکار کر دے، تو آپ کے پاس ایسا گاہک ہے جس کے پاس شہر کی سیٹ ہے مگر کمرہ نہیں، جس کے پیسے کٹ چکے ہیں، اور جرمانے والے ٹکٹ کا ریفنڈ۔ اگر پہلے ہوٹل بک کریں اور فلائٹ بعد میں ناکام ہو، تو آپ کے پاس ایسا کمرہ ہے جسے اکثر مفت منسوخ کیا جا سکتا ہے، یعنی مرمت سستی ہے۔ الٹا خطرہ بھی حقیقی ہے، کیونکہ ناقابل منسوخی ہوٹل ریٹ رکھنے کے لیے سب سے بری چیز ہے، اس لیے اسے پہلے جانے دینے سے پہلے ریٹ کی منسوخی کی شرائط پڑھیں۔
یہ انگوٹھے کا اصول ہے، قانون نہیں؛ نکتہ یہ ہے کہ ترتیب جان بوجھ کر چنیں۔ جو حصہ واپس کرنا آسان ہو اسے مشکل والے سے پہلے کمٹ کریں، کسی بھی کے کمٹ ہونے سے ذرا پہلے دونوں قیمتیں جانچیں، اور تینوں نتائج میں سے ہر ایک کے لیے اپنا قدم لکھ لیں۔ جائزہ لینے والے کم ہی پوچھتے ہیں۔ گاہک ہمیشہ پتا لگا لیتے ہیں۔
ایک سفر، دو بکنگ
جو ڈھانچہ ٹکتا ہے وہ ایک ٹرپ ریکارڈ ہے جس کے پاس دو بکنگ ہیں، ہر ایک کا اپنا حوالہ، اپنی حالت اور اپنی شرائط۔ گاہک کو ایک کل رقم دکھتی ہے۔ آپ کے ڈیٹا بیس کو دو قطاریں دکھتی ہیں، اور کل رقم وہ جمع ہے جو آپ نکالتے ہیں، سپلائر کے پاس موجود کوئی چیز نہیں۔
دونوں حالتیں الگ رکھیں۔ ہوٹل کا "کنفرم" اور فلائٹ کا "ٹکٹڈ" ایک ہی کیفیت نہیں، اور انہیں چپٹا کرنے والا ایک ہی اسٹیٹس کالم دیر سویر آدھے بک شدہ سفر پر "بک" لکھ دے گا۔
تبدیلی کی شرائط بھی الگ رکھیں اور دکھائیں۔ دکھائی گئی کل رقم یہ چھپا دیتی ہے کہ تاریخیں بدلنا ایک حصے پر مفت ترمیم ہے اور دوسرے پر فیس۔ اگر آپ کا فرنٹ اینڈ "تاریخ بدلیں" کو ایک ہی بٹن کے طور پر دکھاتا ہے، تو گاہک کے آپ کی جگہ دریافت کرنے سے پہلے طے کریں کہ جب صرف ایک حصہ کھسک سکے تو وہ کیا کرے گا۔ یہی مارک اپ پر لاگو ہوتا ہے: اگر آپ اسے زیادہ تر بیچنے والوں کی طرح سروس کے حساب سے لگاتے ہیں، تو سفر کی کل رقم دو مارک اپ ہے، اور ایک حصے کے ریفنڈ کو معلوم ہونا چاہیے کہ وہ کون سا مارک اپ لوٹا رہا ہے۔ جڑا ہوا سفر پیسوں میں مہنگا ہوتا ہے، کیونکہ مدیں مختلف ٹائم لائنز پر طے ہوتی ہیں، اور فلائٹ کا ریفنڈ اس وقت نہیں آتا جب ہوٹل کی منسوخی آتی ہے۔
یہ پلیٹ فارم کہاں بیٹھتا ہے
صاف الفاظ میں: پلیٹ فارم فلائٹ اور ہوٹل API فراہم کرتا ہے، اور رسائی خود سروس کلید سے نہیں، بات چیت سے شروع ہوتی ہے۔ سروسز ہر ٹیننٹ کے لیے الگ فعال کی جاتی ہیں، اس لیے جو ٹیننٹ ہوٹل بیچتا ہے اور ٹور نہیں، وہ ٹور والا حصہ نہیں اٹھاتا۔ یہاں ایسی کسی ایک کال کا وعدہ نہیں جو دونوں حصے اٹامک طور پر بک کر دے، اور آپ کو ایسے ڈیزائن نہیں کرنا چاہیے گویا وہ ہو۔ انہیں دو بکنگ کی طرح لیں، ایسے سفر کے نیچے جس کے مالک آپ ہیں۔
اگر ان کے گرد کچھ بنانے سے پہلے اصل کالز اور شرائط دیکھنا چاہتے ہیں، تو ٹریول API صفحے سے شروع کریں اور وہ ترتیب ساتھ لائیں جس میں آپ بک کرنا چاہتے ہیں۔ اگر آپ ابھی یہ طے کر رہے ہیں کہ مفت رسائی سے کیا ملتا ہے، تو مفت ہوٹل بکنگ API میں مفت کی اقسام بیان کی گئی ہیں۔
غلطی کی قیمت
مہنگا ورژن خاموش والا ہے۔ گاہک کو شہر کا ٹکٹ جاری ہو چکا ہے اور کمرہ جا چکا ہے، اور آپ کو پہلی خبر رات کو ایئرپورٹ سے آئے پیغام سے ملتی ہے۔ سستے مگر پھر بھی حقیقی: ایسا چیک آؤٹ جو ایک تسلی بخش کل رقم دکھائے اور قیمت کی جانچ کے بعد دوسرا عدد، جس پر گاہک راضی نہیں تھا؛ ایسا ریفنڈ جو فلائٹ لوٹائے اور ہوٹل بھول جائے؛ اور ایسی حالت جو "بک" کہے جب سپلائر کچھ اور کہتا ہو۔
ان میں سے کسی کو ہوشیار حل نہیں چاہیے۔ اسے یہ چاہیے کہ سفر ایک حقیقی شے ہو، ترتیب ایسا فیصلہ ہو جو کسی نے لکھا ہو، اور دونوں میں سے کسی کے کمٹ ہونے سے ذرا پہلے آخری لمحے پر دونوں قیمتیں دوبارہ جانچی جائیں۔ اسے ایک بار بنا لیں، تو چیک آؤٹ اتنا سادہ دکھ سکتا ہے جتنا ٹکٹ نے مانگا تھا۔