Авіаційне API

Календар тарифів

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 повертає найдешевший кешований тариф на кожен день для маршруту у вашій валюті, із зазначенням актуальності кешу. Додайте returnFrom / returnTo, щоб отримати суми туди й назад для кожної пари дат, і cabin, щоб обмежити клас. Дані надходять із нашого кешу цін — миттєво й без зарахування як пошук у постачальника, — тож використовуйте його, щоб показати календар або смугу «найдешевших днів» перед справжнім пошуком.

Пошук

POST /v1/flights/search з одним сегментом маршруту для перельоту в один бік, двома — для перельоту туди й назад, до шести — для складного маршруту; кількість пасажирів за типами; за потреби клас обслуговування та максимальна кількість пересадок (maxStops). З wait=true відповідь містить усі пропозиції, щойно відповіли всі постачальники; з wait=false ви отримуєте searchId і опитуєте GET /v1/flights/search/{searchId} з курсором, доки complete не стане true.

Кожна пропозиція містить непрозорий offerId, загальну суму у вашій валюті з розбивкою на пасажира, slices → segments (перевізник, номер рейсу, час, літак, клас, багаж), короткий опис умов тарифу та термін дії. Пропозиції дійсні протягом усієї сесії пошуку (близько 20 хвилин).

Ціна та правила

POST /v1/flights/offers/{offerId}/price повторно валідує тариф у постачальника безпосередньо перед підтвердженням і повертає підтверджену ціну, податки та поля пасажира, яких вимагає авіакомпанія (документи, дати народження, програма лояльності). GET .../fare-rules повертає текст штрафних умов; GET .../ancillaries перелічує платний багаж і опції, які можна додати до замовлення.

Додаткові послуги (додатковий багаж)

GET /v1/flights/offers/{offerId}/ancillaries перелічує платні додаткові послуги, які авіакомпанія пропонує для цього тарифу — наразі додаткові норми зареєстрованого багажу, кожна з ключем, кількістю місць / вагою та ціною на пасажира. Платні означає, що вони оцінюються понад тариф і оплачуються разом із замовленням, на відміну від включеної норми, показаної в самій пропозиції.

Щоб придбати їх, додайте ancillaries[] до POST /v1/flights/orders: один запис на кожну послугу з key і passengerIndex (індекс у passengers, починаючи з 0). Вони оцінюються, бронюються й виписуються разом із замовленням і відображаються в сумах квитків замовлення. До замовлення, квиток за яким уже виписано, додаткові послуги додати не можна; вибір місць працюватиме за тією самою схемою.

{
  "offerId": "fo_7Gk2Qp9LcKM5aGqrMQOIzJko",
  "passengers": [{ "type": "ADT", "gender": "M", "firstName": "SAM", "lastName": "TRAVELLER", "dateOfBirth": "1990-05-04" }],
  "contact": { "email": "[email protected]", "phone": "+971501234567" },
  "ancillaries": [{ "key": "BAG20-1", "passengerIndex": 0 }]
}

Створення замовлення

POST /v1/flights/orders з offerId, пасажирами (імена як у паспорті, тип, дата народження, документ для міжнародних маршрутів), контактом і необов’язковим ancillaries[] (див. вище); додайте Idempotency-Key. Ви отримуєте orderId, PNR авіакомпанії, граничний термін виписки та статус held. У пісочниці замовлення потрапляє до тестової системи постачальника й нічого не списується; у продакшні резервується депозит.

Виписка квитків

POST /v1/flights/orders/{orderId}/issue (потрібен Idempotency-Key) виписує електронні квитки й повертає номери квитків для кожного пасажира. Замовлення можна будь-коли прочитати через GET /v1/flights/orders/{orderId}; статус змінюється так: held → issued → cancelled/refunded.

Анулювання, скасування та повернення

GET /v1/flights/orders/{orderId}/refund-quote показує, скільки поверне скасування згідно з правилами тарифу (анулювання в той самий день зазвичай безкоштовне). POST /v1/flights/orders/{orderId}/cancel підтверджує його; повернення зараховується до реєстру операцій вашого депозиту й видно на порталі розробника.