مقایسه API سفر: محورها را بسنجید، نه تأمینکنندهها را

سه ارائه از سه فروشنده را در سه تب باز کردهاید. در هر کدام یک اسلاید با فهرست بلندی از ایرلاینها هست، یک اسلاید با تعداد هتلها، sandbox، REST و JSON و یک ایمیل پشتیبانی. جدولی میسازید، در هر خانه تیک میزنید و جدول به تساوی میرسد. مقایسه API سفر وقتی به شکل چکلیست قابلیتها انجام شود معمولاً همینجا تمام میشود — و این پایان اشتباهی است، چون تفاوتهایی که سال آینده شما را رقم میزنند فقط بعد از go-live پیدا میشوند: رزروی که سمت تأمینکننده موفق شده اما سمت شما timeout خورده، استردادی که هیچکس نمیتواند انجامش دهد، ایرلاینی که در فهرست بود اما از این مسیر نمیشود برایش بلیت صادر کرد.
این نوشته برای توسعهدهنده یا سرپرست فنیای است که باید این تصمیم را بگیرد و بعدها از آن دفاع کند. فروشندهها را رتبهبندی نمیکند. به شما محورهایی برای مقایسه میدهد، یک برنامه دوره آزمایشی که وقتش را صرف شکستها میکند، و چند پرسش کوتاه که زود معلوم میکند با یک تأمینکننده واقعی طرفید یا با کسی که تأمینکننده دیگری را دوباره میفروشد.
چرا چکلیست قابلیتها همیشه به تساوی میرسد
چکلیست میپرسد آیا قابلیتی وجود دارد یا نه. تقریباً هر API سفری میتواند به تقریباً هر سطر جواب مثبت بدهد، چون سطرها در سطح صفحه بازاریابی نوشته شدهاند: جستوجو، قیمت، رزرو، لغو، صدور بلیت، webhook، sandbox. پرسشی که آنها را از هم جدا میکند این نیست که cancel وجود دارد یا نه، بلکه این است که اگر آن را روی رزروی که دوازده ساعت پیش از پرواز صادر شده، روی نرخی با جریمه، از مسیری که محتوایش از شخص ثالث آمده صدا بزنید چه اتفاقی میافتد. چکلیست ستونی برای این ندارد.
مشکل دومی هم هست. کسی که چکلیست را پر میکند معمولاً خود فروشنده است. شما به توصیفی که او از خودش داده نمره میدهید.
مقایسه API سفر بر پایه محورها، نه فروشندهها
جدول «فروشنده × قابلیت» را کنار بگذارید و به جایش محورهایی بگذارید که خودتان، با شواهدی که در دوره آزمایشی جمع کردهاید، به آنها امتیاز میدهید. جدول زیر همانی است که ما به کار میبردیم. میتوانید وزن سطرها را متفاوت بگیرید — کسبوکاری که فقط هتل میفروشد کمتر به صدور بلیت اهمیت میدهد — و بهتر است پیش از پذیرفتنش با آن بحث کنید.
| محور | چکلیست چه میپرسد | آنچه واقعاً باید فهمید | پاسخ ضعیف چه شکلی است |
|---|---|---|---|
| پوشش | چند ایرلاین و هتل؟ | چه تعداد را میتوان از طریق این API در بازارهای شما جستوجو، رزرو و سپس صادر یا تأیید کرد | یک عدد بزرگ بدون تفکیک |
| عمق | endpoint لغو هست؟ | کدام عملیات پس از رزرو برای هر منبع محتوا خودکار است: void، استرداد، reissue، اصلاح نام، خدمات جانبی | «تیم عملیات ما رسیدگی میکند» |
| درستی قیمت | قیمت لحظهای است؟ | قیمت هنگام رزرو چند وقت یکبار با قیمت هنگام جستوجو فرق میکند و API چطور خبر میدهد | «قیمتها همیشه زندهاند» |
| معنای خطا | خطاها مستند شدهاند؟ | آیا خطا میگوید رزرو در چه وضعیتی است، نه فقط اینکه چیزی شکست خورده | یک کد خطای عمومی برای همه شکستها |
| Idempotency | — | آیا تکرار فراخوان رزرو میتواند رزرو دوم بسازد | سکوت، بعد «چنین چیزی ندیدهایم» |
| Supplier of record | — | قرارداد چه کسی، شماره IATA چه کسی، بلیت از BSP چه کسی میگذرد | «با همه GDSهای بزرگ کار میکنیم» |
| دسترسی و پشتیبانی | sandbox دارد؟ | وقتی یک PNR زنده گیر میکند چه کسی جواب میدهد و با چه سرعتی | فقط فرم تیکت، بدون نام مسئول |
دو سطر از این جدول اصلاً پرسشی در چکلیست ندارند. تصادفی نیست: اینها همان سطرهاییاند که وقتی خراب شوند بیشترین هزینه را دارند و ارائه فروشنده کمتر از همه خودش سراغشان میرود.
پوشش همان عمق نیست
فهرست ایرلاینها گمراهکنندهترین اسلاید هر ارائه است. فهرستی از چند صد ایرلاین میتواند چند معنای متفاوت داشته باشد و فقط یکی از آنها چیزی است که شما میخواهید.
بعضی از این ایرلاینها از طریق GDS میآیند و از اول تا آخر قابل رزرو و صدورند. بعضی از طریق اتصال NDC، جایی که جستوجو ممکن است خوب کار کند اما خدمات پس از رزرو — تغییر، استرداد بخشی، افزودن بار — برای آن ایرلاین هنوز دستی باشد. بعضی ایرلاینهای ارزانقیمتیاند که محتوایشان از یک فروشنده دیگر تجمیع شده؛ میتوانید نشانشان دهید، گاهی میتوانید رزروشان کنید، و بعد بلیت از مسیری میرسد که کنترلی بر آن ندارید، در زمانی که نمیتوانید به مشتری قولش را بدهید. و بعضی فقط به این دلیل در فهرستاند که یک بار نرخی در پاسخ جستوجو برگشته است.
ایرلاینی که میتوانید نشانش دهید اما نمیتوانید برایش بلیت صادر کنید پوشش نیست. برای محصول خردهفروشی بدتر از نبودنش است، چون مشتری انتخابش میکند، پول میدهد و بعد منتظر میماند.
هتلها همین شکل را با واژههای دیگر دارند. تعداد اقامتگاهها هم آنهایی را شامل میشود که فروشنده mapping کرده و هم آنهایی را که نکرده؛ نرخهای ثابتی که هفته پیش کش شدهاند کنار موجودی زنده؛ اتاقهای allotment با release period کنار موجودی free-sale. عددی را بخواهید که در شهرهایی که میفروشید بهصورت زنده قابل رزرو است، و بپرسید موارد تکراری میان تأمینکنندههای خودشان چطور ادغام میشود — یک هتل که سه بار با سه قیمت نمایش داده شود تیکت پشتیبانیای است که در راه است.
آزمون عملی باریک است. بیست مسیر و بیست شهر هتلی را که بیشتر حجم کار شما را میسازند بنویسید و از فروشنده بخواهید همانها را از اول تا آخر در sandbox اجرا کند: جستوجو، قیمت، رزرو، صدور یا تأیید، لغو. فروشندهای که عمق دارد بیدردسر این کار را میکند. فروشندهای که فقط اسلاید دارد شروع میکند به حرف زدن درباره اسلاید.
در دوره آزمایشی چه چیزی را بیازمایید: مسیرهای خطا، نه مسیرهای هموار
هر sandboxی یک بلیت یکطرفه اکونومی را در مسیری خلوت با موفقیت رزرو میکند. sandbox برای نشان دادن همین ساخته شده است. ترافیک واقعی شما بخش قابلتوجهی از عمرش را در مسیرهای دیگر میگذراند و دوره آزمایشی تنها لحظه ارزانی است که میتوانید آنها را ببینید.
در دوره آزمایشی این فهرست را اجرا کنید و آنچه API برگرداند را کنار آنچه بعداً واقعاً درست بود ثبت کنید:
- تغییر قیمت میان جستوجو و رزرو. فراخوان رزرو شکست میخورد، با قیمت جدید موفق میشود، یا پاسخی جداگانه برمیگرداند که از شما تأیید میخواهد؟ آیا رابط کاربری شما بدون تجزیه متن پیام میتواند اینها را از هم تشخیص دهد؟
- پیشنهاد منقضیشده. جستوجو کنید، بیشتر از عمر پیشنهاد فروشنده صبر کنید، بعد رزرو کنید. انقضا خطای مخصوص خودش است یا همان خطای «تأمینکننده در دسترس نیست»؟
- تمامشدن ظرفیت هنگام رزرو. موجودیای که میان قیمت و رزرو ناپدید میشود. رزرو در چه وضعیتی است و آیا مجوز پرداخت آزاد میشود؟
- تکرار پس از timeout. درخواست رزرو را بفرستید، پیش از رسیدن پاسخ اتصال را قطع کنید و دوباره بفرستید. حالا یک PNR دارید یا دو تا؟ همین یک آزمون بیشتر از کل باقی دوره آزمایشی درباره فروشنده به شما میگوید.
- رزرو ساخته شد، صدور بلیت شکست خورد. آیا API میتواند PNRی را گزارش کند که وجود دارد اما بلیتش صادر نشده، و مهلت صدور را به شما بگوید؟
- شکست بخشی. درخواست هتل چنداتاقه که یک اتاق تأیید میشود و دیگری نه. رفتوبرگشتی که رفت و برگشتش از دو منبع متفاوت آمدهاند.
- لغو بیرون از بازه رایگان. جریمه پیش از تأیید شما اعلام میشود یا روی صورتحساب کشف میشود؟
- قطعی تأمینکننده. از فروشنده بپرسید چطور میشود آن را شبیهسازی کرد. اگر نمیتواند، بپرسید مشتریانش رفتار سیستم را چطور فهمیدند.
در هر مورد دو چیز را امتیاز میدهید. اول، آیا API درباره وضعیت رزرو حقیقت را میگوید؟ دوم، آیا کد شما میتواند بدون اینکه آدمی متن آزاد را بخواند بر اساس آن حقیقت عمل کند؟ زندگی با APIی که واضح شکست میخورد آسانتر است تا با APIی که مبهم موفق میشود.
درباره سمت پرواز در آنچه مستندات API رزرو بلیط هواپیما نمیگویند مفصلتر نوشتهایم، و درباره طراحی کلاینت برای تأمینکنندههای کند هتل در نوشته موجودی هتل. هر دو همراهان خوبی برای برنامه دوره آزمایشیاند.
پرسشهایی که aggregator کمعمق را لو میدهند
aggregator ایرادی ندارد. بیشتر محتوای سفر از طریق یکی از آنها به بیشتر فروشندگان میرسد. خطر در نوع کمعمق است: لایهای که API لایهای دیگر را دوباره میفروشد، حاشیه سودی رویش میگذارد و نه قرارداد تأمین را در اختیار دارد و نه میز عملیات را. وقتی چیزی خراب میشود، پاسخ باید دو شرکت بالادست برود و برگردد.
پنج پرسش این را زود آشکار میکند:
- supplier of record این رزرو کیست؟ روی قرارداد چه کسی با ایرلاین یا هتل بنا شده است؟
- بلیت از شماره IATA و BSP چه کسی صادر میشود؟ اگر جواب «مال شریکمان» است، بپرسید وقتی قانون نرخ نقض شود ADM به دست چه کسی میرسد.
- وقتی cancel را صدا میزنم، سمت شما چه اتفاقی میافتد؟ یک فراخوان خودکار به تأمینکننده، یا صفی که آدمی آن را برمیدارد؟
- میتوانم خطای بالادست را ببینم؟ لایه کمعمق معمولاً همه شکستها را در یک کد خلاصه میکند، چون خطاهایی را که دریافت میکند کامل نمیفهمد.
- برای رزرو زندهای که گیر کرده با چه کسی تماس بگیرم، و او با چه کسی؟ گامها را بشمارید.
هیچکدام از این پاسخها بهتنهایی ردکننده نیست. شماره IATA شریک میتواند مشکلی نداشته باشد اگر قرارداد روشن بگوید debit memo بر عهده کیست. مهم این است که فروشنده دقیق و سریع جواب بدهد. پاسخهای مبهم اینجا همان پاسخهاییاند که بعداً، در محیط عملیاتی و در ساعتی بدتر، دریافت خواهید کرد.
انتخاب اشتباه چه هزینهای دارد
یکپارچهسازی بخش ارزان ماجراست. بخشهای گران بعداً میرسند و در هیچ برآوردی دیده نمیشوند.
باگ رزرو تکراری یعنی مشتریای که دو بار از او پول کسر شده و PNRی که باید دستی پیدا و لغوش کنید، شاید بعد از بسته شدن بازه void رایگان. رزروی که در بالادست موفق شده اما سمت شما شکست ثبت شده یعنی صندلیای که نگه داشته شده، بعد خودکار لغو شده، و مشتریای که فکر میکند رزرو دارد. ایرلاینی که نشانش دادید اما نتوانستید برایش بلیت صادر کنید یعنی استرداد، عذرخواهی و مشتریای که برنمیگردد. ADM ناشی از قانون نرخی که مسیر فروشنده نقضش کرده روی دوش مالک بلیت میافتد — از پیش بدانید آن مالک شما هستید یا نه.
بعد هزینه تعویض میآید. هر عجیبوغریبی فروشنده که جذبش میکنید — کد وضعیتی که دو معنا دارد، فیلدی که گاهی رشته است — سر از مدل داده شما درمیآورد. دو سال بعد، انتخاب API دیگر یکپارچهسازیای نیست که در یک اسپرینت عوضش کنید؛ شکل جدول رزروهای شماست. دلیل واقعی مقایسه دقیق در همین حالا همین است.
API خود ما کجای این چارچوب است
ما API پرواز و هتل ارائه میکنیم. دسترسی با یک گفتوگو شروع میشود نه با کلید سلفسرویس، که برخی توسعهدهندگان آن را کند میدانند؛ دلیلش این است که همان گفتوگو جایی است که پرسشهای بالا از هر دو طرف پرسیده میشوند — به کدام مسیرها و شهرها نیاز دارید، کدام محتوا را واقعاً میتوانید صادر یا تأیید کنید، و پس از رزرو چه کسی مسئول چه کاری است. اگر در حال مقایسهاید، این فهرست را با خودتان بیاورید. گفتوگو از صفحه API سفر شروع میشود.
هرچه انتخاب میکنید، از روی گزارش دوره آزمایشی انتخاب کنید، نه از روی ارائه. ارائه میگوید فروشنده میخواهد چه باشد. مسیرهای خطا میگویند واقعاً چیست.