API lotnicze

Kalendarz taryf

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 zwraca najtańszą taryfę z pamięci podręcznej dla każdego dnia na trasie, w Twojej walucie, wraz z informacją o aktualności danych. Dodaj returnFrom / returnTo, aby otrzymać sumy tam i z powrotem dla każdej pary dat, oraz cabin, aby ograniczyć klasę. Dane pochodzą z naszej pamięci podręcznej cen — natychmiast i bez liczenia jako wyszukiwanie u dostawcy — więc użyj ich do narysowania kalendarza lub paska „najtańsze dni” przed właściwym wyszukiwaniem.

Wyszukiwanie

POST /v1/flights/search z jednym odcinkiem dla lotu w jedną stronę, dwoma dla lotu tam i z powrotem, do sześciu dla trasy wieloodcinkowej; liczba pasażerów według typu; opcjonalnie klasa kabiny i maksymalna liczba przesiadek (maxStops). Z wait=true odpowiedź zawiera wszystkie oferty, gdy odpowiedzą wszyscy dostawcy; z wait=false otrzymujesz searchId i odpytujesz GET /v1/flights/search/{searchId} z kursorem, aż complete będzie równe true.

Każda oferta zawiera nieprzezroczysty offerId, sumę w Twojej walucie z rozbiciem na pasażerów, odcinki → segmenty (przewoźnik, numer lotu, godziny, samolot, klasa, bagaż), podsumowanie warunków taryfy i termin ważności. Oferty są ważne przez czas trwania sesji wyszukiwania (około 20 minut).

Cena i zasady

POST /v1/flights/offers/{offerId}/price ponownie weryfikuje taryfę u dostawcy tuż przed zatwierdzeniem i zwraca potwierdzoną cenę, podatki i pola pasażera wymagane przez linię (dokumenty, daty urodzenia, program lojalnościowy). GET .../fare-rules zwraca treść warunków i kar; GET .../ancillaries wymienia płatny bagaż i opcje, które możesz dodać do zamówienia.

Usługi dodatkowe (dodatkowy bagaż)

GET /v1/flights/offers/{offerId}/ancillaries wymienia płatne dodatki, które linia oferuje przy tej taryfie — obecnie dodatkowe limity bagażu rejestrowanego, każdy z key, pieces / weight i ceną za pasażera. Płatne oznacza, że są wyceniane ponad taryfę i rozliczane z zamówieniem, w odróżnieniu od bagażu wliczonego pokazanego w samej ofercie.

Aby je kupić, dodaj ancillaries[] do POST /v1/flights/orders: jeden wpis na dodatek z key i passengerIndex (indeks od 0 w passengers). Są wyceniane, rezerwowane i wystawiane razem z zamówieniem i pojawiają się w sumach biletów zamówienia. Dodatków nie można dodać do zamówienia, dla którego bilety zostały już wystawione; wybór miejsc będzie działał według tego samego schematu.

{
  "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 }]
}

Utwórz zamówienie

POST /v1/flights/orders z offerId, pasażerami (imiona i nazwiska jak w paszporcie, typ, data urodzenia, dokument przy trasach międzynarodowych), kontaktem i opcjonalnym ancillaries[] (patrz wyżej); dodaj Idempotency-Key. Otrzymasz orderId, PNR linii lotniczej, termin wystawienia biletu i status held. W sandboksie zamówienie trafia do systemu testowego dostawcy i nic nie jest pobierane; na produkcji kwota jest blokowana na depozycie.

Wystaw bilety

POST /v1/flights/orders/{orderId}/issue (wymagany Idempotency-Key) wystawia bilety elektroniczne i zwraca numery biletów dla każdego pasażera. Zamówienie możesz odczytać w dowolnym momencie przez GET /v1/flights/orders/{orderId}; status przechodzi przez held → issued → cancelled/refunded.

Unieważnienie, anulowanie i zwrot

GET /v1/flights/orders/{orderId}/refund-quote informuje, ile zwróci anulowanie zgodnie z zasadami taryfy (unieważnienie tego samego dnia jest zwykle bezpłatne). POST /v1/flights/orders/{orderId}/cancel je zatwierdza; zwrot trafia do rejestru Twojego depozytu i jest widoczny w portalu dewelopera.