Letecké API

Tarifný kalendár

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 vráti najlacnejšiu uloženú tarifu na každý deň pre danú trasu vo vašej mene, spolu s informáciou, aká čerstvá je cache. Pridajte returnFrom / returnTo pre spiatočné sumy pre každú dvojicu dátumov a cabin na obmedzenie triedy. Údaje pochádzajú z našej cenovej cache — okamžite a nikdy sa nerátajú ako vyhľadávanie u dodávateľa —, takže ich použite na vykreslenie kalendára alebo pásu „najlacnejších dní“ pred skutočným vyhľadávaním.

Vyhľadávanie

POST /v1/flights/search s jedným úsekom pre jednosmerný let, dvoma pre spiatočný, až šiestimi pre viacúsekovú cestu; počty cestujúcich podľa typu; voliteľne trieda a maximálny počet prestupov (maxStops). S wait=true obsahuje odpoveď všetky ponuky, keď odpovedia všetci dodávatelia; s wait=false dostanete searchId a dopytujete GET /v1/flights/search/{searchId} s kurzorom, kým complete nie je true.

Každá ponuka obsahuje neprehľadné offerId, celkovú sumu vo vašej mene s rozpisom na cestujúceho, slices → segments (dopravca, číslo letu, časy, lietadlo, trieda, batožina), súhrn tarifných podmienok a platnosť. Ponuky platia počas celej relácie vyhľadávania (približne 20 minút).

Cena a pravidlá

POST /v1/flights/offers/{offerId}/price tesne pred potvrdením znovu overí tarifu u dodávateľa a vráti potvrdenú cenu, dane a údaje o cestujúcom, ktoré letecká spoločnosť vyžaduje (doklady, dátumy narodenia, vernostný program). GET .../fare-rules vráti text sankčných podmienok; GET .../ancillaries zobrazí platenú batožinu a možnosti, ktoré môžete pridať k objednávke.

Doplnkové služby (batožina navyše)

GET /v1/flights/offers/{offerId}/ancillaries zobrazí spoplatnené doplnky, ktoré letecká spoločnosť k danej tarife ponúka — zatiaľ dodatočné limity zapísanej batožiny, každý s kľúčom, počtom kusov / hmotnosťou a cenou na cestujúceho. Spoplatnené znamená, že sa oceňujú nad rámec tarify a účtujú sa spolu s objednávkou, na rozdiel od zahrnutého limitu uvedeného v samotnej ponuke.

Ak ich chcete kúpiť, pridajte ancillaries[] do POST /v1/flights/orders: jeden záznam na každý doplnok s key a passengerIndex (index od 0 v poli passengers). Oceňujú sa, rezervujú a vystavujú spolu s objednávkou a zobrazujú sa v sumách leteniek objednávky. K objednávke s už vystavenou letenkou doplnky pridať nemožno; výber sedadla bude nasledovať rovnaký vzor.

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

Vytvorenie objednávky

POST /v1/flights/orders s offerId, cestujúcimi (mená ako v pase, typ, dátum narodenia, doklad pri medzinárodných itinerároch), kontaktom a voliteľným ancillaries[] (pozri vyššie); pridajte Idempotency-Key. Dostanete orderId, PNR leteckej spoločnosti, časový limit na vystavenie a stav held. V sandboxe objednávka pristane v testovacom systéme dodávateľa a nič sa neúčtuje; v produkcii sa zablokuje záloha.

Vystavenie leteniek

POST /v1/flights/orders/{orderId}/issue (vyžaduje Idempotency-Key) vystaví elektronické letenky a vráti čísla leteniek pre každého cestujúceho. Objednávku si môžete kedykoľvek prečítať cez GET /v1/flights/orders/{orderId}; stav prechádza held → issued → cancelled/refunded.

Storno, zrušenie a refundácia

GET /v1/flights/orders/{orderId}/refund-quote vám povie, koľko zrušenie vráti podľa tarifných pravidiel (storno v ten istý deň je zvyčajne bezplatné). POST /v1/flights/orders/{orderId}/cancel ho potvrdí; refundácia sa pripíše do účtovnej knihy vašej zálohy a je viditeľná v portáli pre vývojárov.