Letecké API

Tarifní kalendář

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 vrací nejlevnější uložený tarif pro trasu na každý den, ve vaší měně, spolu s informací, jak čerstvá je mezipaměť. Přidejte returnFrom / returnTo pro součty zpátečních letů podle dvojice dat a cabin pro omezení třídy. Obsluhuje se z naší cenové mezipaměti — okamžitě a nikdy se nezapočítává jako vyhledávání u dodavatele — použijte ho proto k vykreslení kalendáře nebo pruhu „nejlevnějších dnů“ před skutečným vyhledáváním.

Vyhledávání

POST /v1/flights/search s jedním úsekem pro jednosměrný let, dvěma pro zpáteční a až šesti pro let s více městy; počty cestujících podle typu; volitelně kabina a maximální počet přestupů (maxStops). S wait=true obsahuje odpověď všechny nabídky, jakmile odpoví všichni dodavatelé; s wait=false dostanete searchId a dotazujete se na GET /v1/flights/search/{searchId} s cursor, dokud není complete rovno true.

Každá nabídka nese neprůhledné offerId, celkovou částku ve vaší měně s rozpisem na cestujícího, úseky → segmenty (dopravce, číslo letu, časy, letadlo, kabina, zavazadla), souhrn tarifních podmínek a dobu platnosti. Nabídky platí po dobu relace vyhledávání (přibližně 20 minut).

Cena a pravidla

POST /v1/flights/offers/{offerId}/price těsně před závazným krokem znovu ověří tarif u dodavatele a vrátí potvrzenou cenu, daně a údaje o cestujících, které letecká společnost vyžaduje (doklady, data narození, věrnostní program). GET .../fare-rules vrací text sankčních podmínek; GET .../ancillaries uvádí placená zavazadla a možnosti, které můžete k objednávce přidat.

Doplňkové služby (zavazadla navíc)

GET /v1/flights/offers/{offerId}/ancillaries uvádí zpoplatněné doplňky, které letecká společnost k danému tarifu nabízí — zatím navýšení odbaveného zavazadla, každé s key, počtem kusů / hmotností a cenou na cestujícího. Zpoplatněné znamená, že se účtují nad rámec tarifu a fakturují s objednávkou, na rozdíl od zahrnutého zavazadla uvedeného přímo v nabídce.

Chcete-li je koupit, přidejte ancillaries[] do POST /v1/flights/orders: jednu položku na každý doplněk s key a passengerIndex (indexováno od 0 v rámci passengers). Oceňují se, rezervují a vystavují společně s objednávkou a objeví se v součtech letenek objednávky. K objednávce s již vystavenou letenkou nelze doplňky přidat; výběr sedadla bude následovat stejný model.

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

Vytvoření objednávky

POST /v1/flights/orders s offerId, cestujícími (jména jako v pase, typ, datum narození, doklad u mezinárodních itinerářů), kontaktem a volitelnými ancillaries[] (viz výše); přidejte Idempotency-Key. Obdržíte orderId, PNR letecké společnosti, lhůtu pro vystavení letenky a stav held. V testovacím prostředí objednávka skončí v testovacím systému dodavatele a nic se neúčtuje; v produkci se zablokuje záloha.

Vystavení letenek

POST /v1/flights/orders/{orderId}/issue (vyžaduje Idempotency-Key) vystaví elektronické letenky a vrátí čísla letenek pro každého cestujícího. Objednávku si kdykoli načtete přes GET /v1/flights/orders/{orderId}; stav přechází held → issued → cancelled/refunded.

Void, storno a refundace

GET /v1/flights/orders/{orderId}/refund-quote vám řekne, kolik storno podle tarifních pravidel vrátí (void ve stejný den je obvykle zdarma). POST /v1/flights/orders/{orderId}/cancel jej provede; refundace se připíše do účetní knihy vaší zálohy, viditelné ve vývojářském portálu.