فلائٹ قیمتوں کی API: نظر آنے والا نمبر ابھی کرایہ کیوں نہیں

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