پیش از سپردن کار به شرکت یکپارچهسازی API در دبی

سه پیشفاکتور روی میز است. هر سه شرکت یکپارچهسازی نمونهکار سایتهای گردشگری دارند، هر سه قول میدهند «API پرواز را به سایت شما وصل میکنیم» و ارزانترینشان میتواند از هفتهی بعد شروع کند. شما در دیره آژانسی با شش کارمند و مشتریان سازمانیِ ثابت دارید و از اینکه نرخها را از اکسترانت تأمینکننده بردارید و دوباره در پیام واتساپ تایپ کنید خسته شدهاید. انتخاب شرکت یکپارچهسازی API در دبی که از همه کاربلدتر به نظر میرسد، انگار کل تصمیم است.
در واقع حدود یکسوم آن است. تصمیمهایی که تعیین میکنند سایت میفروشد یا نه، در هیچیک از این سه پیشفاکتور نیستند، چون کد نیستند. اینکه چه کسی با تأمینکننده قرارداد بسته، بلیت به نام چه کسی صادر میشود، پول میان رزرو و صدور کجا میماند، و وقتی مشتری کنسل میکند استرداد را چه کسی انجام میدهد. پیمانکار میتواند همهی اینها را به هم وصل کند. اما نمیتواند به جای شما هیچکدامشان باشد.
این نوشته برای صاحب کسبوکاری است که شرح کار را امضا میکند، نه برای برنامهنویسی که آن را میخواند.
شرکت یکپارچهسازی API در دبی چه چیزی تحویل میدهد و چه چیزی نه
شرکت یکپارچهسازی کدِ میان API تأمینکننده و سایت شما را مینویسد: فرم جستجو، درخواستی که موجودی را میپرسد، بررسی دوبارهی قیمت پیش از پرداخت، درخواست رزرو، صفحههایی که نتیجه را نشان میدهند و، اگر شرح کار بگوید، درخواستهای کنسلی و استرداد. شرکتهای خوب بخشهای کسلکننده اما مهم را هم میبینند: تلاش دوباره وقتی تأمینکننده جواب نمیدهد، لاگهایی که ردگیری رزرو ناموفق را ممکن میکنند، محیط آزمایشی که مثل محیط اصلی رفتار میکند.
آنچه نمیتواند به دستتان بدهد، همهی چیزهایی است که آن سوی این کد قرار دارد. پیش از نوشتن حتی یک خط، آژانس به اینها نیاز دارد:
- حساب تأمینکننده به نام خود آژانس، با دسترسی API که به همان حساب داده شده باشد؛
- اختیار صدور بلیت، یا مجوز خودش یا consolidator که از طرف او صادر کند؛
- توافق مالی با آن تأمینکننده: سپرده، سقف اعتبار، یا پرداخت کارتی که مستقیم عبور داده شود؛
- کسی که کارهای پس از صدور (void، استرداد، صدور مجدد، تغییر برنامهی پرواز) را انجام دهد، از راه API یا، اگر نشد، دستی.
پیمانکاری که پیشنهاد میکند «طرف تأمینکننده را ما درست میکنیم» معمولاً پیشنهاد میدهد حساب خودش را به شما قرض بدهد. برای میانبُر یک نمونهی اولیه، این میتواند منطقی باشد. برای یک کسبوکار یعنی سایت رزرو شما روی رابطهای کار میکند که مال شما نیست و نمیتوانید با خودتان ببرید.
شرح کار: هفت بند برای قرارداد
بیشتر اختلافها با پیمانکار به جملهای برمیگردد که هیچکس ننوشته بود. اینها را با زبان ساده در سندی که امضا میکنید بیاورید و پاسخ هرکدام را کتبی بخواهید.
- حساب تأمینکننده و کلیدهای API به نام کیست. به نام آژانس. کلیدها اطلاعات ورود هستند: در گاوصندوق رمزهای شما میمانند و پیمانکار دسترسی میگیرد، نه مالکیت.
- میزبانی سایت با کیست و دامنه مال کیست. دامنه به نام آژانس ثبت میشود. حساب میزبانی هم مال آژانس است، یا قرارداد دقیقاً میگوید چطور منتقل میشود.
- کدام عملیات در محدودهی کار است. با نام فهرست کنید: جستجو، قیمت، رزرو، صدور، کنسلی، استرداد، تغییر. هرچه در فهرست نباشد، تا آخر عمر سایت یک ایمیل به میز تأمینکننده باقی میماند. استرداد و تغییر بیش از همه جا میافتند، چون هیچ دمویی آنها را نشان نمیدهد.
- وقتی تأمینکننده API را عوض کرد، نگهداری با کیست. تأمینکنندهها نسخهها را بازنشسته و نام فیلدها را عوض میکنند. ساختِ قیمتمقطوع بدون بند نگهداری، روزی تمام میشود که نسخهی اول تغییر کند.
- تحویل یعنی چه. کد منبع در مخزنی که مال آژانس است، همهی اطلاعات ورود، و سندی که برنامهنویس دیگری بتواند با آن کار را ادامه دهد. «یک فایل zip برایتان میفرستیم» تحویل نیست.
- آغاز به کار چطور اثبات میشود. یک رزرو آزمایشی از جستجو تا صدور بلیت در محیط آزمایشی تأمینکننده، همراه با یک کنسلی، پیش از آنکه کسی کارت مشتری واقعی را بگیرد.
- دادهی مشتری چه میشود. نام مسافران، اطلاعات گذرنامه و شناسههای پرداخت: کجا نگه داشته میشوند، چه کسی میتواند آنها را بخواند و چطور پاک میشوند.
نوشتن هیچکدام دانش فنی نمیخواهد. و توافق روی هرکدام پیش از ساخت، ارزانتر از چانهزدن دربارهاش بعد از ساخت است.
سه راه برای آوردن محتوای تأمینکننده به سایت شما
گرفتن پیمانکار برای API یک تأمینکننده یک راه است. ارزشش را دارد که پیش از آنکه یک پیشفاکتور به جای شما تصمیم بگیرد، آن را کنار دو راه دیگر ببینید.
| راه | رابطه با تأمینکننده دست کیست | چه کسی اتصال را سرپا نگه میدارد | آژانس هنوز چه چیزی باید بسازد | هزینهی جدا شدن |
|---|---|---|---|---|
| پیمانکار سایت شما را به API تأمینکننده وصل میکند | اگر شرح کار بگوید، آژانس؛ وگرنه اغلب پیمانکار | پیمانکار با قرارداد نگهداری، یا هیچکس | پنل مدیریت، مارکآپ، سوابق مشتری، گزارشها، پرداخت، صفحههای پشتیبانی | اگر کد و کلیدها مال شما باشد کم؛ وگرنه ساخت دوباره |
| پیمانکار سایت شما را به API یک پلتفرم وصل میکند | قراردادهای تأمینکننده با پلتفرم؛ حساب آژانس در پلتفرم با آژانس | طرف تأمینکننده با پلتفرم؛ طرف شما با پیمانکار | سایت شما، و هرچه API پلتفرم پوشش نمیدهد | بازنویسی طرف شما برای API دیگر |
| فروشگاه وایتلیبل که از قبل وصل است | پلتفرم، از طریق حساب آژانس | پلتفرم | محتوا، تصمیمهای قیمتگذاری، مشتریان خودتان | انتقال دامنه و فهرست مشتریان به ارائهدهندهی دیگر |
ردیفی که ارزش بحث دارد اولی است. بیشترین کنترل را میدهد و بیشترین بار را روی دوش شما میگذارد: هر تغییر تأمینکننده، هر سرویس تازه و هر عملیاتی که ساخت اول جا انداخت، پروژهای دیگر با پیشفاکتوری دیگر میشود.
اینکه چطور جستجو را روی سایتی که همین حالا دارید بگذارید، در افزودن جستجوی پرواز به وبسایت موجود آمده و انتخاب اینکه API چه کسی پشت آن باشد در انتخاب ارائهدهندهی API رزرو پرواز. این نوشته دربارهی قراردادِ دور این کار است.
جایگاه این پلتفرم
پلتفرمی که پشت این وبلاگ است API پرواز و هتل ارائه میدهد. دسترسی با گفتگو شروع میشود نه با کلید سلفسرویس، چون نخستین پرسشها همانهایی است که بالا آمد (کدام سرویسها، کدام بازار، پول چطور جابهجا میشود)، نه اینکه کدام endpoint صدا زده شود. سرویسها برای هر حساب جداگانه فعال میشوند و هر حساب پنل مدیریت خودش را با رزروها، مشتریان، مارکآپها و گزارشهای خودش دارد، پس ستون «هنوز باید بسازد» در ردیف دوم کوتاهتر از آن است که به نظر میرسد.
اگر قرار است یک شرکت یکپارچهسازی طرف شما را بسازد، این گفتگو را پیش از پذیرفتن پیشفاکتور انجام دهید تا شرح کار بر اساس APIای نوشته شود که واقعاً به آن وصل میشود. نقطهی شروع صفحهی APIهای سفر است.
شرح کار ضعیف چه هزینهای دارد
سایت راه میافتد. جستجو کار میکند، قیمتها درست به نظر میرسند و نخستین رزرو یک پنجشنبهشب میرسد. اما به نام شما قابل صدور نیست، چون حساب تأمینکننده مال پیمانکار است و بلیت با توافق او صادر میشود. کارت مشتری هم شارژ شده است. حالا رزروی در دست دارید که نه میتوانید از سایت خودتان صادرش کنید و نه مسترد.
یا یک سال خوب کار میکند. بعد تأمینکننده به نسخهی تازهی API میرود، رزرو متوقف میشود و پیمانکاری که قرارداد قیمتمقطوعش با تحویل تمام شده بود، برای پروژهای تازه پیشفاکتور میدهد. شما میپردازید، چون تنها کسانی که کد را میفهمند همانهایی هستند که پیشفاکتور دادهاند.
یا پیمانکار فقط سرش جای دیگری گرم است. مشتری باید اسمش روی بلیت اصلاح شود، عملیات تغییر هرگز در محدوده نبوده، و دو نفر از کارمندانتان تمام بعدازظهر به میز تأمینکننده ایمیل میزنند. این دقیقاً همان کاری است که سایت قرار بود از دوشتان بردارد.
هرکدام از اینها یک جمله است که در شرح کار جا افتاده بود. کد هر بار سالم بود.