ٹریول API کا موازنہ: سپلائرز نہیں، معیار پرکھیں

تین ٹیبز میں تین سپلائرز کی پریزنٹیشنز کھلی ہیں۔ ہر ایک میں ایئر لائنز کی لمبی فہرست والی ایک سلائیڈ ہے، ہوٹلوں کی تعداد والی ایک سلائیڈ، ایک sandbox، REST اور JSON، اور سپورٹ کا ایک ای میل۔ آپ اسپریڈشیٹ بناتے ہیں، ہر خانے میں نشان لگاتے ہیں، اور اسپریڈشیٹ برابری پر ختم ہو جاتی ہے۔ فیچر چیک لسٹ کی صورت میں کیا گیا ٹریول API کا موازنہ عموماً یہیں ختم ہوتا ہے، اور یہ غلط انجام ہے، کیونکہ جو فرق آپ کے اگلے سال کا فیصلہ کریں گے وہ لائیو ہونے کے بعد ہی سامنے آتے ہیں: اس بکنگ پر جو سپلائر کے ہاں کامیاب ہوئی مگر آپ کی طرف timeout ہو گئی، اس ریفنڈ پر جسے کوئی پراسیس نہیں کر سکتا، اس ایئر لائن پر جو فہرست میں تھی مگر اس روٹ سے اس کا ٹکٹ جاری نہیں ہو سکتا۔
یہ تحریر اس ڈیولپر یا ٹیکنیکل لیڈ کے لیے ہے جسے یہ فیصلہ کرنا ہے اور بعد میں اس کا دفاع بھی کرنا ہے۔ یہ سپلائرز کی درجہ بندی نہیں کرتی۔ یہ آپ کو موازنے کے محور دیتی ہے، ایک ایسا ٹرائل پلان جو اپنا وقت ناکامیوں پر لگاتا ہے، اور چند سوال جو جلد بتا دیتے ہیں کہ آپ کسی سپلائر سے بات کر رہے ہیں یا کسی اور کے سپلائر کو آگے بیچنے والے سے۔
فیچر چیک لسٹ ہمیشہ برابری پر کیوں ختم ہوتی ہے
چیک لسٹ پوچھتی ہے کہ کوئی صلاحیت موجود ہے یا نہیں۔ تقریباً ہر ٹریول API تقریباً ہر سطر پر ہاں کہہ سکتا ہے، کیونکہ سطریں مارکیٹنگ صفحے کی سطح پر لکھی جاتی ہیں: سرچ، قیمت، بکنگ، منسوخی، ٹکٹنگ، webhooks، sandbox۔ ان میں فرق کرنے والا سوال یہ نہیں کہ cancel موجود ہے یا نہیں، بلکہ یہ کہ جب آپ اسے روانگی سے بارہ گھنٹے پہلے کسی ٹکٹ شدہ بکنگ پر، جرمانے والے کرائے پر، ایسے روٹ سے کال کریں جس میں مواد کسی تیسرے فریق سے آیا ہو، تو کیا ہوتا ہے۔ چیک لسٹ میں اس کا کوئی کالم نہیں۔
دوسرا مسئلہ بھی ہے۔ چیک لسٹ عموماً خود سپلائر بھرتا ہے۔ آپ اس کی اپنی بیان کردہ تصویر کو نمبر دے رہے ہیں۔
سپلائرز کے بجائے محوروں پر مبنی ٹریول API کا موازنہ
سپلائر بمقابلہ فیچر والی جدول کی جگہ ایسے محور رکھیں جنہیں آپ خود، ٹرائل میں جمع کیے گئے ثبوت کی بنیاد پر، نمبر دیں۔ نیچے والی جدول وہ ہے جو ہم استعمال کریں گے۔ آپ سطروں کو مختلف وزن دے سکتے ہیں — صرف ہوٹل بیچنے والے کاروبار کو ٹکٹنگ کی فکر کم ہوتی ہے — اور اپنانے سے پہلے اس پر بحث کر لینا بہتر ہے۔
| محور | چیک لسٹ کیا پوچھتی ہے | اصل میں کیا معلوم کرنا ہے | کمزور جواب کیسا لگتا ہے |
|---|---|---|---|
| کوریج | کتنی ایئر لائنز اور ہوٹل؟ | آپ کی مارکیٹوں میں اس API سے کتنوں کو سرچ، بک اور ٹکٹ یا کنفرم کیا جا سکتا ہے | بغیر تقسیم کے ایک بڑا عدد |
| گہرائی | کیا منسوخی کا endpoint ہے؟ | ہر مواد کے ذریعے کے لیے بکنگ کے بعد کون سے کام خودکار ہیں: void، ریفنڈ، ری اِشو، نام کی درستی، اضافی سروسز | ”یہ ہماری آپریشنز ٹیم دیکھتی ہے“ |
| قیمت کی درستی | کیا قیمت ریئل ٹائم ہے؟ | بکنگ کے وقت قیمت سرچ والی قیمت سے کتنی بار مختلف ہوتی ہے اور API یہ کیسے بتاتا ہے | ”قیمتیں ہمیشہ لائیو ہوتی ہیں“ |
| ایرر کا مفہوم | کیا ایررز دستاویزی ہیں؟ | کیا ایرر یہ بتاتا ہے کہ بکنگ کس حالت میں ہے، نہ کہ صرف یہ کہ کچھ ناکام ہوا | ہر ناکامی کے لیے ایک ہی عمومی کوڈ |
| Idempotency | — | کیا دوبارہ بھیجی گئی بکنگ کال دوسری بکنگ بنا سکتی ہے | خاموشی، پھر ”ہم نے ایسا نہیں دیکھا“ |
| معاہداتی سپلائر | — | ٹکٹ کس کے معاہدے، کس کے IATA نمبر، کس کے BSP سے گزرتا ہے | ”ہم تمام بڑے GDS کے ساتھ کام کرتے ہیں“ |
| رسائی اور سپورٹ | کیا sandbox ہے؟ | لائیو PNR اٹک جائے تو کون جواب دیتا ہے، اور کتنی جلدی | ایک ٹکٹ فارم اور کوئی نامزد رابطہ نہیں |
ان میں سے دو سطروں کا چیک لسٹ میں کوئی سوال ہی نہیں۔ یہ اتفاق نہیں: یہی وہ سطریں ہیں جو بگڑنے پر سب سے مہنگی پڑتی ہیں، اور یہی وہ ہیں جن کا ذکر سیلز پریزنٹیشن خود سے سب سے کم کرتی ہے۔
کوریج گہرائی نہیں ہے
ایئر لائنز کی فہرست کسی بھی پریزنٹیشن کی سب سے گمراہ کن سلائیڈ ہوتی ہے۔ کئی سو کیریئرز کی فہرست کئی مختلف باتوں کا مطلب رکھ سکتی ہے، اور ان میں سے صرف ایک وہ ہے جو آپ چاہتے ہیں۔
ان میں سے کچھ کیریئرز GDS کے ذریعے آتے ہیں اور شروع سے آخر تک بک اور ٹکٹ کیے جا سکتے ہیں۔ کچھ NDC کنکشنز سے آتے ہیں، جہاں سرچ اچھی چل سکتی ہے مگر بکنگ کے بعد کی سروس — تبدیلیاں، جزوی ریفنڈ، بیگ شامل کرنا — اس ایئر لائن کے لیے اب بھی دستی ہو سکتی ہے۔ کچھ لو کاسٹ ایئر لائنز ہیں جن کا مواد کسی اور ری سیلر سے جمع کیا جاتا ہے: آپ انہیں دکھا سکتے ہیں، کبھی بک بھی کر سکتے ہیں، اور پھر ٹکٹ ایسے راستے سے آتا ہے جو آپ کے قابو میں نہیں، ایسی مدت میں جس کا آپ کسٹمر سے وعدہ نہیں کر سکتے۔ اور کچھ فہرست میں صرف اس لیے ہیں کہ کبھی کسی سرچ کے جواب میں ان کا کوئی کرایہ آ گیا تھا۔
جس کیریئر کو آپ دکھا سکیں مگر ٹکٹ نہ کر سکیں، وہ کوریج نہیں۔ ریٹیل پروڈکٹ کے لیے یہ اس کی غیر موجودگی سے بھی بدتر ہے، کیونکہ کسٹمر اسے چنتا ہے، ادائیگی کرتا ہے، اور پھر انتظار کرتا ہے۔
ہوٹلوں کی شکل بھی یہی ہے، بس الفاظ مختلف ہیں۔ پراپرٹیز کی گنتی میں وہ ہوٹل بھی شامل ہیں جنہیں سپلائر نے میپ کیا اور وہ بھی جنہیں نہیں کیا؛ پچھلے ہفتے کیش ہونے والے جامد ریٹس لائیو دستیابی کے ساتھ؛ ریلیز مدت والے الاٹمنٹ کمرے فری سیل انوینٹری کے ساتھ۔ ان شہروں میں لائیو بک ہونے والی پراپرٹیز کی تعداد پوچھیں جہاں آپ بیچتے ہیں، اور پوچھیں کہ ان کے اپنے سپلائرز کے درمیان ڈپلیکیٹس کیسے ملائے جاتے ہیں — ایک ہی ہوٹل کا تین قیمتوں پر تین بار آنا ایک ایسا سپورٹ ٹکٹ ہے جو بس آنے والا ہے۔
عملی امتحان محدود ہے۔ وہ بیس روٹس اور بیس ہوٹل شہر لکھ لیں جو آپ کے حجم کا بڑا حصہ بناتے ہیں — مثلاً لاہور–دبئی، کراچی–جدہ، دبئی اور مکہ کے ہوٹل — اور سپلائر سے کہیں کہ بالکل یہی sandbox میں شروع سے آخر تک چلتے ہوئے دکھائے: سرچ، قیمت، بکنگ، ٹکٹنگ یا کنفرمیشن، منسوخی۔ جس سپلائر کے پاس گہرائی ہے وہ یہ بلا جھجک کر دے گا۔ جس کے پاس صرف سلائیڈ ہے وہ سلائیڈ کی بات شروع کر دے گا۔
ٹرائل میں کیا جانچیں: ایرر کے راستے، خوشگوار راستے نہیں
ہر sandbox کسی پرسکون روٹ پر اکانومی کا یک طرفہ ٹکٹ کامیابی سے بک کر لیتا ہے۔ اسے بنایا ہی یہ دکھانے کے لیے گیا ہے۔ آپ کی پروڈکشن ٹریفک اپنی زندگی کا خاصا حصہ باقی راستوں پر گزارے گی، اور ٹرائل انہیں دیکھنے کا واحد سستا موقع ہے۔
ٹرائل میں یہ فہرست چلائیں، اور ساتھ ساتھ لکھیں کہ API نے کیا لوٹایا اور بعد میں حقیقت کیا نکلی:
- سرچ اور بکنگ کے درمیان قیمت کی تبدیلی۔ کیا بکنگ کال ناکام ہوتی ہے، نئی قیمت پر کامیاب ہوتی ہے، یا تصدیق مانگنے والا الگ جواب دیتی ہے؟ کیا آپ کا انٹرفیس پیغام کا متن پڑھے بغیر یہ فرق پہچان سکتا ہے؟
- میعاد گزری آفر۔ سرچ کریں، سپلائر کی بتائی ہوئی آفر کی مدت سے زیادہ انتظار کریں، پھر بک کریں۔ کیا میعاد ختم ہونا ایک الگ ایرر ہے، یا وہی ایرر جو ”سپلائر دستیاب نہیں“ کا ہے؟
- بکنگ کے وقت سیٹیں ختم۔ قیمت اور بکنگ کے درمیان غائب ہونے والی انوینٹری۔ بکنگ کس حالت میں ہے، اور کیا ادائیگی کی ہولڈ چھوڑ دی جاتی ہے؟
- timeout کے بعد دوبارہ کوشش۔ بکنگ کی درخواست بھیجیں، جواب سے پہلے کنکشن توڑ دیں، پھر دوبارہ بھیجیں۔ اب آپ کے پاس ایک PNR ہے یا دو؟ یہ ایک ٹیسٹ کسی سپلائر کے بارے میں باقی پورے ٹرائل سے زیادہ بتا دیتا ہے۔
- بکنگ بن گئی، ٹکٹنگ ناکام۔ کیا API ایسا PNR رپورٹ کر سکتا ہے جو موجود ہے مگر ٹکٹ نہیں ہوا، اور کیا وہ ٹکٹنگ کی آخری تاریخ بتاتا ہے؟
- جزوی ناکامی۔ کئی کمروں والی ہوٹل درخواست جس میں ایک کمرہ کنفرم ہو اور دوسرا نہیں۔ ایسا راؤنڈ ٹرپ جس میں جانے اور آنے کے حصے مختلف ذرائع سے آئیں۔
- مفت مدت کے بعد منسوخی۔ کیا جرمانہ تصدیق سے پہلے بتایا جاتا ہے، یا انوائس پر پتہ چلتا ہے؟
- سپلائر کی بندش۔ سپلائر سے پوچھیں کہ اسے سیمولیٹ کیسے کیا جائے۔ اگر وہ نہ بتا سکے تو پوچھیں کہ اس کے کلائنٹس کو کیسے پتہ چلا کہ اس وقت سسٹم کیسا برتاؤ کرتا ہے۔
ہر کیس میں آپ دو چیزوں کو نمبر دے رہے ہیں۔ پہلی: کیا API بکنگ کی حالت کے بارے میں سچ بتاتا ہے؟ دوسری: کیا آپ کا کوڈ اس سچ پر عمل کر سکتا ہے بغیر اس کے کہ کوئی انسان آزاد متن پڑھے؟ جو API صاف طور پر ناکام ہو اس کے ساتھ گزارا اس سے آسان ہے جو مبہم انداز میں کامیاب ہو۔
فلائٹ والے پہلو پر ہم نے فلائٹ بکنگ API کی دستاویزات میں کیا نہیں لکھا ہوتا میں تفصیل سے لکھا ہے، اور سست ہوٹل سپلائرز کے لیے کلائنٹ ڈیزائن پر ہوٹل دستیابی والی تحریر میں۔ دونوں ٹرائل پلان کے ساتھ کارآمد ہیں۔
وہ سوال جو کمزور ایگریگیٹر کو بے نقاب کرتے ہیں
ایگریگیٹر میں کوئی برائی نہیں۔ زیادہ تر ٹریول مواد زیادہ تر فروخت کنندگان تک کسی ایگریگیٹر کے ذریعے ہی پہنچتا ہے۔ خطرہ کمزور ایگریگیٹر کا ہے: ایک ایسی پرت جو کسی دوسری پرت کا API آگے بیچتی ہے، اوپر مارجن لگاتی ہے، اور نہ سپلائر کے معاہدے کی مالک ہوتی ہے نہ آپریشنز ڈیسک کی۔ جب کچھ ٹوٹتا ہے تو جواب کو دو کمپنیاں اوپر جا کر واپس آنا پڑتا ہے۔
پانچ سوال یہ جلد سامنے لے آتے ہیں:
- اس بکنگ کا معاہداتی سپلائر کون ہے؟ یہ ایئر لائن یا ہوٹل کے ساتھ کس کے معاہدے پر قائم ہے؟
- ٹکٹ کس کے IATA نمبر اور کس کے BSP سے جاتا ہے؟ اگر جواب ”ایک پارٹنر کا“ ہو تو پوچھیں کہ کرائے کا اصول ٹوٹنے پر ADM کس کو ملتا ہے۔
- جب میں cancel کال کرتا ہوں تو آپ کی طرف کیا ہوتا ہے؟ سپلائر کو خودکار کال، یا ایک قطار جسے کوئی شخص اٹھاتا ہے؟
- کیا میں اوپر والے ذریعے کا ایرر دیکھ سکتا ہوں؟ کمزور پرت ہر ناکامی کو ایک ہی کوڈ میں دبا دیتی ہے، کیونکہ وہ ملنے والے ایررز کو پوری طرح سمجھتی نہیں۔
- اٹکی ہوئی لائیو بکنگ کے لیے میں کس کو فون کروں، اور وہ کس کو کرتے ہیں؟ کڑیاں گنیں۔
ان میں سے کوئی جواب اکیلے نااہل نہیں کرتا۔ پارٹنر کا IATA نمبر ٹھیک ہو سکتا ہے اگر معاہدہ صاف بتائے کہ ڈیبٹ میمو کا بوجھ کون اٹھائے گا۔ اہم یہ ہے کہ سپلائر درست اور جلد جواب دے۔ آج کے مبہم جواب وہی ہیں جو آپ کو بعد میں، پروڈکشن میں، کسی بدتر وقت ملیں گے۔
غلط انتخاب آپ کو کتنا مہنگا پڑتا ہے
انٹیگریشن سستا حصہ ہے۔ مہنگے حصے بعد میں آتے ہیں اور کسی تخمینے میں نظر نہیں آتے۔
ڈپلیکیٹ بکنگ کا بگ یعنی ایک کسٹمر سے دو بار رقم کٹی اور ایک PNR جسے ہاتھ سے ڈھونڈ کر منسوخ کرنا ہے، شاید مفت void کی مدت بند ہونے کے بعد۔ ایسی بکنگ جو اوپر کامیاب ہوئی جبکہ آپ کی طرف ناکامی درج ہوئی، یعنی ایک سیٹ روکی گئی، پھر خودبخود منسوخ ہو گئی، اور ایک کسٹمر جو سمجھتا ہے کہ اس کی بکنگ ہو چکی ہے۔ ایسا کیریئر جو دکھایا گیا مگر ٹکٹ نہ ہو سکا، یعنی ریفنڈ، معذرت اور ایک کسٹمر جو واپس نہیں آتا۔ سپلائر کے روٹ کی وجہ سے ٹوٹنے والے کرائے کے اصول کا ADM ٹکٹ کے مالک پر آتا ہے — پہلے سے یقینی بنا لیں کہ وہ آپ ہیں یا نہیں۔
پھر سپلائر بدلنے کی لاگت ہے۔ سپلائر کی ہر عجیب عادت جسے آپ جذب کرتے ہیں — ایسا اسٹیٹس کوڈ جس کے دو مطلب ہوں، ایسی فیلڈ جو کبھی string ہو — آپ کے ڈیٹا ماڈل میں جا بیٹھتی ہے۔ دو سال بعد API کا انتخاب کوئی ایسی انٹیگریشن نہیں رہتا جسے ایک sprint میں بدل دیا جائے؛ وہ آپ کی بکنگ ٹیبل کی شکل بن چکا ہوتا ہے۔ ابھی احتیاط سے موازنہ کرنے کی اصل وجہ یہی ہے۔
ہمارا اپنا API اس طریقے میں کہاں آتا ہے
ہم فلائٹ اور ہوٹل API فراہم کرتے ہیں۔ رسائی self-service کلید سے نہیں بلکہ ایک گفتگو سے شروع ہوتی ہے، جسے کچھ ڈیولپرز سست سمجھتے ہیں؛ وجہ یہ ہے کہ اسی گفتگو میں اوپر والے سوال دونوں طرف سے پوچھے جاتے ہیں — آپ کو کون سے روٹس اور شہر چاہئیں، کون سا مواد آپ واقعی ٹکٹ یا کنفرم کر سکیں گے، اور بکنگ کے بعد کون کیا سنبھالے گا۔ اگر آپ موازنہ کر رہے ہیں تو یہ فہرست ساتھ لائیں۔ یہ گفتگو ٹریول API کے صفحے سے شروع ہوتی ہے۔
جو بھی چنیں، پریزنٹیشن سے نہیں، ٹرائل کے ریکارڈ سے چنیں۔ پریزنٹیشن بتاتی ہے کہ سپلائر کیا بننا چاہتا ہے۔ ایرر کے راستے بتاتے ہیں کہ وہ کیا ہے۔