تاریخچهٔ تغییرات

تغییرات مهم API سفر، از جدیدترین به قدیمی‌ترین. هر نسخه تغییراتی را که روی یکپارچه‌سازی شما اثر دارند یک‌جا نشان می‌دهد.

v2.5.0#

• افزوده‌شده. سایت مستندات در /docs که پرواز، هتل، تفریحات و اندپوینت‌های عمومی را پوشش می‌دهد؛ همراه با نمونه‌های قابل اجرای cURL، JavaScript و Python، جست‌وجو و پوستهٔ روشن و تیره.
• افزوده‌شده. توصیف OpenAPI 3.1 در /openapi.yaml برای وارد کردن در کلاینت‌های API.
• افزوده‌شده. صفحه‌های معرفی محصول در /flights-api، /hotels-api و /activities-api.

v2.4.0#

• افزوده‌شده. جست‌وجوی شهر در GET /Geo/cities/search؛ یک تکمیل خودکار عمومی روی فهرست جهانی مکان‌ها که نام شهرها و نام‌های جایگزینشان را به زبان‌های مختلف تطبیق می‌دهد.
• تغییر. پاسخ‌ها زبان درخواستی شما را رعایت می‌کنند. متن به زبان‌های محلی‌شده در اختیار کلاینت‌های API قرار نمی‌گیرد؛ فیلدهای انگلیسی متناظر را بخوانید.

v2.3.0#

• افزوده‌شده. API تفریحات زیر /Activity/v2: کاتالوگ (products، products/all، products/by-location)، انواع محصول، ظرفیت بر اساس تاریخ و سانس، رزروها، واچرها و پیکربندی.
• افزوده‌شده. دریافت رویدادهای وب‌هوک به روش polling برای ده نوع رویداد تفریحات زیر /Activity/v2/webhook-events.
• افزوده‌شده. مرتب‌سازی بر اساس پرفروش‌ترین‌ها، شمارندهٔ فروش برای هر محصول و جست‌وجوی نام محصول به هر زبانی که ذخیره شده باشد.
• تغییر. قیمت‌های تفریحات به دلار آمریکا (USD) یکسان‌سازی شده‌اند.
• اصلاح. جست‌وجوی ظرفیت، تاریخ‌ها و سانس‌های گذشته را بر اساس منطقهٔ زمانی محلی تفریح حذف می‌کند.

v2.2.0#

• افزوده‌شده. API پیشنهادی v2 هتل زیر /v2/Hotel: جست‌وجوی ظرفیت در حالت شهر و هتل، اعتبارسنجی نرخ، رزرو، سفارش، لغو، اطلاعات رزرو و تمدید مهلت پرداخت.
• افزوده‌شده. جست‌وجو و بازیابی عمومی مکان هتل زیر /v2/Hotel/cities/*، از جمله بازیابی گروهی بر اساس شناسه.
• تغییر. قیمت‌های هتل به دلار آمریکا یکسان‌سازی شده‌اند و نرخ اعتبارسنجی‌شده ۱۵ دقیقه معتبر می‌ماند.
• تغییر. فیلدهای پیش‌پرداخت از پاسخ‌های v2 هتل حذف شده‌اند.
• افزوده‌شده. مسیرهای v1 هتل برای یکپارچه‌سازی‌های موجود همچنان در دسترس‌اند. بخش نسخه‌بندی را ببینید.

v2.1.0#

• افزوده‌شده. جست‌وجوی جریانی پرواز در AirLowFareSearchIncremental روی server-sent events، برای نمایش سریع اولین نتایج.
• افزوده‌شده. تقویم قیمت پرواز در AirPriceCalendar: ارزان‌ترین نرخ هر روز برای یک مسیر.
• افزوده‌شده. NumberOfResults برای تنظیم اندازهٔ سبد نتایج، و AirLowFareSearch2 به‌عنوان سبد نتایج جایگزین.
• تغییر. جست‌وجو چند منبع موجودی را در یک پاسخ تجمیع می‌کند و نتایج را با حفظ تنوع دسته‌ها (ارزان‌ترین، سریع‌ترین، مستقیم، سطح‌های بار مجاز) محدود می‌کند.
• اصلاح. نتایج تکراری ناشی از کدشِیر و کلاس نرخ، برای هر پرواز فیزیکی به یک پیشنهاد ادغام می‌شوند.

v2.0.0#

• ناسازگار. CabinType در درخواست جست‌وجو یک enum عددی است: 1 اکونومی، 2 پریمیوم اکونومی، 3 بیزینس، 4 پریمیوم بیزینس، 5 فرست، 6 پریمیوم فرست. CabinClassCode در پاسخ هم اکنون از همین enum استفاده می‌کند.
• ناسازگار. Gender مسافران در AirBook: 0 مرد، 1 زن.
• تغییر. جست‌وجو کلاس پرواز درخواستی را اعمال می‌کند و پیشنهادهای خارج از آن کلاس را حذف می‌کند.

v1.0.0#

• افزوده‌شده. احراز هویت مبتنی بر نشست: Authenticate/CreateSession یک SessionId برمی‌گرداند و Authenticate/EndSession آن را پایان می‌دهد.
• افزوده‌شده. فرایند پرواز: جست‌وجو، قوانین نرخ، بار مجاز، اعتبارسنجی مجدد، رزرو، صدور بلیت، لغو، استرداد و اطلاعات رزرو. به‌علاوهٔ AirSearchData برای خواندن دوبارهٔ یک جست‌وجوی قبلی و AirAddBookingNotes.
• افزوده‌شده. فرایند رزرو هتل نسخهٔ v1.
• افزوده‌شده. اندپوینت‌های عمومی: موجودی اعتبار، جزئیات خطا و تاریخچهٔ نشست‌ها.