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} с cursor, докато complete стане true.

Всяка оферта съдържа непрозрачен offerId, общата сума във вашата валута с разбивка по пътник, slices → segments (превозвач, номер на полета, часове, самолет, класа, багаж), обобщение на тарифните условия и срок на валидност. Офертите са валидни, докато трае сесията за търсене (около 20 минути).

Цена и правила

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

Допълнителни услуги (допълнителен багаж)

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

За да ги купите, добавете ancillaries[] към POST /v1/flights/orders: по един запис за всяко допълнение с key и passengerIndex (индекс от 0 в passengers). Те се ценообразуват, резервират и издават заедно с поръчката и се появяват в общите суми на билетите ѝ. Допълнения не могат да се добавят към поръчка с вече издадени билети; изборът на места ще следва същия модел.

{
  "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. В sandbox поръчката попада в тестовата система на доставчика и нищо не се таксува; в production депозитът се резервира.

Издаване на билети

POST /v1/flights/orders/{orderId}/issue (изисква се Idempotency-Key) издава електронни билети и връща номерата на билетите за всеки пътник. Четете поръчката по всяко време с GET /v1/flights/orders/{orderId}; статусът преминава през held → issued → cancelled/refunded.

Анулиране (void), отмяна и възстановяване

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