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

دبئی میں API انٹیگریشن کمپنی رکھنے سے پہلے

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

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

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

یہ تحریر اس مالک کے لیے ہے جو اسٹیٹمنٹ آف ورک پر دستخط کرے گا، اس ڈیولپر کے لیے نہیں جو اسے پڑھے گا۔

دبئی میں API انٹیگریشن کمپنی کیا دے سکتی ہے اور کیا نہیں

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

جو وہ آپ کو نہیں دے سکتی، وہ اس کوڈ کی دوسری طرف کی ہر چیز ہے۔ ایک بھی لائن لکھے جانے سے پہلے ایجنسی کو چاہیے:

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

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

بریف: اسٹیٹمنٹ آف ورک کے لیے سات باتیں

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

  1. سپلائر اکاؤنٹ اور API keys کس کے نام پر ہیں۔ ایجنسی کے۔ Keys خفیہ رسائی کی معلومات ہیں: وہ آپ کے پاس ورڈ والٹ میں رہتی ہیں، اور انٹیگریٹر کو رسائی ملتی ہے، ملکیت نہیں۔
  2. سائٹ کون ہوسٹ کرتا ہے اور ڈومین کس کے پاس ہے۔ ڈومین ایجنسی کے نام رجسٹرڈ ہے۔ ہوسٹنگ اکاؤنٹ ایجنسی کا ہے، یا معاہدے میں واضح لکھا ہے کہ وہ کیسے منتقل ہوگا۔
  3. کون سے آپریشن اسکوپ میں ہیں۔ انہیں نام سے لکھیں: سرچ، قیمت، بکنگ، ٹکٹنگ، کینسل، ریفنڈ، تبدیلی۔ جو فہرست میں نہیں، وہ سائٹ کی پوری زندگی سپلائر کی ڈیسک کو بھیجی جانے والی ای میل ہی رہے گا۔ سب سے زیادہ ریفنڈ اور تبدیلی رہ جاتے ہیں، کیونکہ کوئی ڈیمو انہیں کبھی نہیں دکھاتا۔
  4. سپلائر کے API بدلنے پر دیکھ بھال کون کرے گا۔ سپلائر پرانے ورژن بند کرتے ہیں اور فیلڈز کے نام بدلتے ہیں۔ مینٹیننس کی شق کے بغیر فکسڈ پرائس کام اسی دن ختم ہو جاتا ہے جس دن پہلا ورژن بدلتا ہے۔
  5. حوالگی کا مطلب کیا ہے۔ ایجنسی کی ملکیت والی ریپوزٹری میں سورس کوڈ، ہر رسائی کی تفصیل، اور ایک دستاویز جس سے کوئی دوسرا ڈیولپر کام آگے بڑھا سکے۔ "ہم آپ کو zip بھیج دیں گے" حوالگی نہیں ہے۔
  6. لائیو ہونا کیسے ثابت ہوگا۔ سپلائر کے ٹیسٹ ماحول میں سرچ سے ٹکٹ تک ایک ٹیسٹ بکنگ، کینسلیشن سمیت — کسی حقیقی گاہک کا کارڈ چارج ہونے سے پہلے۔
  7. گاہکوں کے ڈیٹا کا کیا ہوگا۔ مسافروں کے نام، پاسپورٹ کی تفصیلات اور ادائیگی کے حوالے: کہاں محفوظ ہوتے ہیں، کون پڑھ سکتا ہے، اور کیسے مٹائے جاتے ہیں۔

ان میں سے کسی کے لیے تکنیکی پس منظر درکار نہیں۔ ہر بات کام شروع ہونے سے پہلے طے کرنا، بعد میں سودے بازی کرنے سے سستا پڑتا ہے۔

سپلائر کا مواد اپنی سائٹ پر لانے کے تین طریقے

کسی سپلائر کے API پر انٹیگریٹر رکھنا ایک راستہ ہے۔ کوئی کوٹیشن آپ کے لیے فیصلہ کرے، اس سے پہلے اسے باقی دو راستوں کے ساتھ رکھ کر دیکھنا بہتر ہے۔

راستہسپلائر سے تعلق کس کے پاسکنکشن کو چالو کون رکھتا ہےایجنسی کو پھر بھی کیا بنانا ہےچھوڑنے کی قیمت
انٹیگریٹر آپ کی سائٹ کو کسی سپلائر کے API سے جوڑتا ہےایجنسی کے پاس، اگر بریف میں لکھا ہو؛ ورنہ اکثر انٹیگریٹر کے پاسمینٹیننس معاہدے پر انٹیگریٹر، یا کوئی نہیںایڈمن، مارک اپ، گاہکوں کا ریکارڈ، رپورٹس، ادائیگیاں، سروسنگ اسکرینیںکوڈ اور keys آپ کے ہوں تو تھوڑی؛ نہ ہوں تو دوبارہ بنانا
انٹیگریٹر آپ کی سائٹ کو کسی پلیٹ فارم کے API سے جوڑتا ہےسپلائر معاہدے پلیٹ فارم کے پاس؛ ایجنسی کے پاس پلیٹ فارم پر اس کا اکاؤنٹسپلائر کی طرف پلیٹ فارم؛ آپ کی طرف انٹیگریٹرآپ کی سائٹ، اور جو پلیٹ فارم کا API کور نہیں کرتااپنی طرف کا حصہ دوسرے API پر دوبارہ لکھنا
پہلے سے جڑا ہوا white-label اسٹور فرنٹپلیٹ فارم، ایجنسی کے اکاؤنٹ کے ذریعےپلیٹ فارممواد، قیمتوں کے فیصلے، آپ کے اپنے گاہکڈومین اور گاہکوں کی فہرست کسی دوسرے فراہم کنندہ کے پاس لے جانا

بحث کے لائق قطار پہلی ہے۔ یہ سب سے زیادہ اختیار دیتی ہے اور سب سے زیادہ بوجھ بھی آپ پر ڈالتی ہے: سپلائر کی ہر تبدیلی، ہر نئی سروس اور پہلے ورژن میں رہ جانے والا ہر آپریشن ایک اور پروجیکٹ بن جاتا ہے، ایک اور کوٹیشن کے ساتھ۔

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

یہ پلیٹ فارم کہاں آتا ہے

اس بلاگ کے پیچھے کا پلیٹ فارم فلائٹ اور ہوٹل API فراہم کرتا ہے۔ رسائی خودکار key سے نہیں، بات چیت سے شروع ہوتی ہے، کیونکہ پہلے سوال وہی ہیں جو اوپر ہیں (کون سی سروسز، کون سی مارکیٹ، پیسہ کیسے چلتا ہے)، یہ نہیں کہ کون سا endpoint کال کرنا ہے۔ سروسز ہر اکاؤنٹ کے لیے الگ سے فعال ہوتی ہیں، اور ہر اکاؤنٹ کا اپنا ایڈمن پینل ہے جس میں اس کی اپنی بکنگز، گاہک، مارک اپ اور رپورٹس ہیں — اس لیے دوسری قطار کا "پھر بھی کیا بنانا ہے" والا کالم جتنا دکھتا ہے اس سے چھوٹا ہے۔

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

کمزور بریف کی قیمت

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

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

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

ان میں سے ہر معاملہ بریف میں رہ جانے والا ایک جملہ ہے۔ کوڈ ہر بار ٹھیک تھا۔

Tekravel اداریہ

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

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