جایگزین Amadeus Self Service API: مهاجرت در یک هفته

خبرش را از یک health check ناموفق میگیرید، یا از یک کاربر. endpoint جستوجویی که اپلیکیشن پرواز شما از نخستین نمونهٔ اولیه صدا میزد، خطایی برمیگرداند که هرگز ندیدهاید، و پورتالی که کلیدهایتان را در آن مدیریت میکردید دیگر وجود ندارد. اگر دنبال جایگزین Amadeus Self Service API هستید، احتمالاً همین حالا در همین وضعیتاید: محصولی که کار میکند، کدی که حول درخواستهای یک تأمینکننده شکل گرفته، و فرصتی کوتاه پیش از آنکه کاربران متوجه شوند جستوجو از کار افتاده است.
دربارهٔ این فروشنده فقط یک واقعیت ارزش گفتن دارد، و فقط یکی. Amadeus پورتال Self-Service API خود را در ۱۷ ژوئیهٔ ۲۰۲۶ تعطیل کرد و توسعهدهندگان تازه را به کانال Enterprise میفرستد که بر پایهٔ قرارداد کار میکند. این نوشته بیش از این دربارهٔ آن چیزی نمیگوید. پرسش مفید این است که چه چیزی جایش را میگیرد، و چطور میشود در حدود یک هفته جابهجا شد بیآنکه بخشهایی که هنوز کار میکنند از نو ساخته شوند.
سلفسرویس واقعاً چه چیزی به شما میداد
آسان است که پورتال قدیمی را فقط «یک API پرواز» به یاد بیاورید و دنبال API پرواز دیگری بروید. این کار چیزی را نادیده میگیرد که آن را برای یک استارتاپ دونفره یا پروژهٔ آخر هفته مفید میکرد. عمدتاً سه چیز:
- حالت آزمایشیای که در یک بعدازظهر به آن میرسیدید. ثبتنام، گرفتن کلید، فراخوانی جستوجو. کسی نمیپرسید شرکت شما چه کاری میکند.
- پرداخت به اندازهٔ مصرف. برای همان چیزی که فراخوانی میکردید پول میدادید، پس محصولی با صد کاربر همانقدر هزینه داشت که محصولی با صد کاربر باید داشته باشد.
- بدون چرخهٔ فروش. لازم نبود کسی پیش از نوشتن کد شما را تأیید کند.
قرارداد سازمانی هر سه را وارونه میکند. دسترسی پس از یک گفتوگوی تجاری میآید، قیمت با مذاکره تعیین میشود، و محیط آزمایشی وقتی میرسد که مدارک برسند. هیچیک از اینها از دید فروشنده غیرمنطقی نیست؛ توزیع محتوای ایرلاینها تعهدات واقعی دارد. اما برنامهٔ شما را تغییر میدهد. اگر حساب کرده بودید که یک کلید API را با کلیدی دیگر عوض کنید، پاسخ صادقانه این است که بیشتر جایگزینهای جدی دیگر اینطور کار نمیکنند، از جمله همانی که این سایت ارائه میدهد. توضیحش در ادامه آمده است.
سه مسیر به سوی جایگزین Amadeus Self Service API
اگر نام فروشندهها را کنار بگذارید، سه نوع جایگزین میماند. تفاوتشان کمتر در JSON است و بیشتر در اینکه با چه کسی قرارداد میبندید و در نهایت چه کسی بلیت را صادر میکند.
| مسیر | زمان تا نخستین رزرو واقعی | محتوایی که میتوان انتظار داشت | حق صدور بلیت در دست کیست |
|---|---|---|---|
| قرارداد مستقیم با GDS | طولانیترین: بررسی تجاری، گواهیگیری، سپس توسعه | محتوای گستردهٔ GDS؛ NDC و ایرلاینهای کمهزینه به قراردادی بستگی دارند که امضا میکنید | خود شما، اگر اعتبارنامهٔ IATA دارید؛ وگرنه همچنان به کسی نیاز دارید که داشته باشد |
| API یک تجمیعکننده | متوسط: ورود سبکتر، اما انتظار قرارداد را داشته باشید | ترکیبی از GDS، NDC و LCC، بسته به منابعی که تجمیعکننده وصل کرده است | معمولاً خود تجمیعکننده، یا یکی از شرکای صدور بلیت او |
| API یک کنسولیداتور | اغلب کوتاهترین راه تا بلیت صادرشده، چون مسئلهٔ صدور از پیش حل شده است | هرچه کنسولیداتور میفروشد: نرخهای قراردادی و خالص او، بهاضافهٔ آنچه تأمینکنندگانش دارند | کنسولیداتور، با اعتبارنامهٔ خودش |
ممکن است با ستون میانی موافق نباشید، و برای موقعیت خودتان باید آن را بسنجید. تیمی که از قبل اعتبارنامه دارد و یک نیروی تجاری در کنارش است، شاید مسیر GDS را سریعتر از آنچه جدول نشان میدهد بیابد. اما بیشتر توسعهدهندگانی که روی sandbox سلفسرویس ساختند، هرگز حق صدور بلیت نداشتهاند، و همان ستون آخر تعیین میکند پس از جابهجایی چه مقدار از محصولتان هنوز کار میکند.
دلیلش این است. جستوجو و قیمتگذاری عملیات خواندناند؛ هر سه مسیر آنها را به شما میدهند. صدور بلیت یک عمل مالی است که با اعتبارنامهٔ کسی انجام و از طریق BSP یا معادل آن تسویه میشود، و اگر آن کس شما نیستید، با او به توافق نیاز دارید. تیمهایی که از این پرسش میگذرند، در پایان یک صفحهٔ جستوجوی زیبا دارند و دکمهٔ رزروی که رزروی میسازد که کسی پولش را نمیدهد.
محتوا ستون دیگری است که باید آهسته خواند. محتوای GDS و محتوای NDC نرخهای یکسانی نیستند، و ایرلاینهای کمهزینه اغلب در هیچکدام نیستند. اگر کاربران شما بیشتر در منطقهای پر از ایرلاینهای کمهزینه مسیرهای کوتاه پرواز میکنند، مسیری با پوشش عالی GDS هم ممکن است نتایج کمرمقی برگرداند. این تمایز را در NDC API یا GDS: چه چیزی برای یکپارچهسازان تغییر کرد بررسی کردهایم.
دسترسی در اینجا چطور کار میکند، و چرا این هم فقط یک کلید نیست
این پلتفرم API پرواز و هتل ارائه میدهد. دسترسی با یک گفتوگو آغاز میشود، نه با کلید سلفسرویس. این را صریح میگوییم، چون بدترین اتفاق این هفته برای شما این است که جایی به امید همان تجربهٔ قدیمی ثبتنام کنید و روز چهارم بفهمید یک تأیید انسانی سر راهتان است.
گفتوگو بیشتر دربارهٔ پرسشهای جدول است: چه میسازید، کاربرانتان چه کسانیاند، به صدور بلیت نیاز دارید یا فقط جستوجو و قیمت، و در کدام بازارها میفروشید. این پاسخها تعیین میکنند چه محتوایی میگیرید و رزروها چگونه تسویه میشوند. اگر میخواهید آغازش کنید، از صفحهٔ APIهای سفر شروع میشود.
هر جا که میروید، در نخستین ایمیل یک پرسش را تکرار کنید: آیا کلید آزمایشی سلفسرویس وجود دارد، و پیش از محیط عملیاتی چه باید اتفاق بیفتد؟ پاسخ روشن نشانهٔ خوبی برای بقیهٔ یکپارچهسازی است. پاسخ مبهم هم چیزی به شما میگوید.
چکلیست مهاجرت، به ترتیبی که چیزها خراب میشوند
بیشتر یکپارچهسازیهای سلفسرویس یک شکل داشتند: جستوجو، قیمت، ساخت سفارش، صدور، و سپس رسیدگی به هر آنچه پس از وجود بلیت پیش میآید. هر مرحله را با تأمینکنندهٔ تازه دوباره بیازمایید، گویی هرگز آن را ننوشتهاید. نام درخواستها فرق خواهد کرد؛ آنچه آسیب میزند فرضهای پنهان در کد شماست.
- جستوجو. مدل پرسوجوی خود (مبدأ، مقصد، تاریخها، مسافران، کابین) را با درخواست تازه تطبیق دهید. بررسی کنید سن کودک و نوزاد چطور فرستاده میشود، آیا سفر چندشهری فراخوانی جداگانه است، و نتیجهٔ خالی چه شکلی دارد. فهرست خالی و خطا دو چیز متفاوتاند، و رابط شما احتمالاً با هر دو یکسان رفتار میکند.
- شناسهٔ پیشنهاد. بفهمید شناسهٔ یک پیشنهاد چه مدت معتبر است و آیا پس از بارگذاری دوبارهٔ صفحه باقی میماند. کدی که پیشنهاد را در نشست نگه میداشت و ده دقیقه بعد قیمتش را میگرفت، به شکلهای تازهای شکست میخورد.
- قیمت. قیمتگذاری دوباره پیش از رزرو نزد بیشتر تأمینکنندگان اختیاری نیست. حالتی را که قیمت تغییر کرده مدیریت کنید و تصمیم بگیرید کاربر در آن لحظه چه میبیند.
- سفارش. نام مسافران، فیلدهای مدارک، اطلاعات تماس. قالبها را پیش از ارسال در سمت خودتان اعتبارسنجی کنید؛ سفارشی که پس از پرداخت مشتری رد شود، گرانترین باگ این فهرست است.
- بلیت. مطمئن شوید که فراخوانی سفارش، بلیت را هم صادر میکند یا صدور مرحلهای جداگانه با مهلت زمانی خودش است. پیش از گرفتن پول از هر کسی بدانید بلیت با اعتبارنامهٔ چه کسی صادر میشود.
- پس از صدور. لغو، void، استرداد، تغییر برنامهٔ پرواز. اینها فراخوانیهاییاند که نمونهٔ اولیه هرگز لازم نداشت و محصول فعال در همان ماه نخست به آنها نیاز دارد. بپرسید آیا در API وجود دارند یا از مسیر پشتیبانی انجام میشوند.
برای یک برنامهٔ آزمون کاملتر، از جمله اینکه چه چیزی را میتوان شبیهسازی کرد و چه چیزی را هرگز، برنامهٔ آزمون sandbox ما برای APIهای سفر را ببینید. اگر از سمت یکپارچهسازی میآیید، اتصال API رزرو بلیت هواپیما کل جریان را مرور میکند.
هزینهٔ یک مهاجرت شتابزده
وسوسه این است که تأمینکنندهٔ تازه را پشت رابط کلاینت قدیمی بپیچید و همین که جستوجو نتیجه داد، منتشر کنید. جستوجو خوب به نظر میرسد. آنچه شکست میخورد همهٔ چیزهایی است که دمو نشان نداد.
قیمتی که میان جستوجو و سفارش تغییر کرده و به شکل خطای خام به کاربر نشان داده شود، رزرو را از دست میدهد. سفارشی که بدون صدور ساخته شود، چون تأمینکنندهٔ تازه این دو مرحله را جدا میکند و کد شما نه، مسافری را باقی میگذارد که خیال میکند بلیت دارد و ندارد. جریان استردادی که بیصدا هیچ کاری نمیکند تا کسی به پشتیبانی بنویسد، به برگشت وجه کارت تبدیل میشود. هر کدام از اینها را یک بار میتوان تاب آورد. تکرارشان در میان کاربران، اعتمادی را از شما میگیرد که یک محصول کوچک سفر با آن زنده است.
هزینهٔ آرامتری هم هست. اگر مسیری را انتخاب کنید چون این هفته سریعترین بود و معلوم شود محتوایی را که کاربرانتان جستوجو میکنند ندارد، دو بار مهاجرت میکنید. یک روز صرف پرسشهای محتوا و صدور بلیت، پیش از هر خط کد، ارزانترین بیمهٔ کل این کار است.
تقریباً یک هفته
روز اول صرف پرسشها میشود: کدام مسیر، کدام محتوا، اعتبارنامهٔ چه کسی. روزهای دوم و سوم صرف جستوجو و قیمتگذاری با تأمینکنندهٔ تازه. روز چهارم صرف سفارش و صدور از ابتدا تا انتها، همراه با حالتهای خطا. روز پنجم صرف کارهای پس از صدور و خواندن لاگهای خودتان. اگر گفتوگو با یک تأمینکننده بیش از یک روز طول کشید، همزمان بر اساس مستنداتش کدنویسی را آغاز کنید؛ شکل درخواستها پس از اینکه یک بار دیدیدشان بهندرت تغییر میکند.
حس آن بعدازظهری را نخواهد داشت که نخستین کلید سلفسرویس خود را گرفتید. لازم هم نیست. آنچه اکنون میسازید باید بلیتهایی صادر کند که کسی پشتشان میایستد.