نسخه‌بندی
نسخهٔ API سفر با مسیر URL مشخص می‌شود. اندپوینت‌ها پایدارند و مسیرهای قدیمی‌تر همچنان کار می‌کنند.
هیچ هدر تاریخی یا پارامتر نسخه‌ای وجود ندارد. هر مسیر یا پیشوند v2/ دارد یا ندارد. هر جا که هر دو وجود دارند، پشتشان یک موتور رزرو مشترک است؛ بنابراین می‌توانید هر بار یک اندپوینت را مهاجرت دهید.
احراز هویت#
احراز هویت در دو مسیر وجود دارد. هر دو یک عملیات روی یک مخزن نشست هستند، پس SessionId گرفته‌شده از هر کدام همه‌جا کار می‌کند. یکی را انتخاب کنید.
| v1 | v2 |
|---|---|
/Authenticate/CreateSession | /v2/Authenticate/CreateSession |
/Authenticate/EndSession | /v2/Authenticate/EndSession |
پرواز#
پرواز فقط یک نسخه دارد. همهٔ مسیرها زیر /Air/ و بدون پیشوند نسخه هستند.
هتل#
هتل هر دو نسخه را دارد. مسیر v2 پیشنهادی است و جست‌وجو و بازیابی عمومی مکان و جست‌وجوی ظرفیت کامل‌تری را اضافه می‌کند. اندپوینت‌های رزرو در هر دو پیشوند از یک موتور استفاده می‌کنند. یکپارچه‌سازی‌های جدید باید از v2 استفاده کنند.
| v1 | v2 | توضیح |
|---|---|---|
/Hotel/cities/search | /v2/Hotel/cities/search | عمومی، بدون نشست. |
| - | /v2/Hotel/cities/lookup | فقط v2. عمومی. |
/Hotel/HotelAvailability | /v2/Hotel/HotelAvailability | ساختار درخواست یکسان. |
/Hotel/HotelCheckRate | /v2/Hotel/HotelCheckRate | یکسان. |
/Hotel/HotelBook | /v2/Hotel/HotelBook | موتور مشترک. |
/Hotel/HotelOrder | /v2/Hotel/HotelOrder | موتور مشترک. |
/Hotel/HotelCancelDisplay | /v2/Hotel/HotelCancelDisplay | موتور مشترک. |
/Hotel/HotelCancel | /v2/Hotel/HotelCancel | موتور مشترک. |
/Hotel/HotelBookingData | /v2/Hotel/HotelBookingData | موتور مشترک. |
/Hotel/HotelExtendPaymentDeadline | /v2/Hotel/HotelExtendPaymentDeadline | موتور مشترک. |
تفریحات#
تفریحات فقط در /Activity/v2/ وجود دارد و نسخهٔ v1 ندارد.
منسوخ‌سازی#
در حال حاضر هیچ چیزی منسوخ نشده است. مسیرهای v1 هتل برای یکپارچه‌سازی‌های موجود در دسترس می‌مانند. اگر روزی اندپوینتی کنار گذاشته شود، پیش از حذف با برچسب Breaking و یک یادداشت مهاجرت در تاریخچهٔ تغییرات اعلام می‌شود.