API za letove

Kalendar cijena

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 vraća najjeftiniju predmemoriranu tarifu po danu za rutu, u vašoj valuti, uz podatak o svježini predmemorije. Dodajte returnFrom / returnTo za povratne ukupne iznose po paru datuma i cabin za ograničenje razreda. Poslužuje se iz naše predmemorije cijena — trenutačno, i nikad se ne računa kao pretraživanje kod dobavljača — pa ga koristite za prikaz kalendara ili trake „najjeftinijih dana” prije stvarnog pretraživanja.

Pretraživanje

POST /v1/flights/search s jednim sliceom za jedan smjer, dva za povratno putovanje, do šest za više gradova; broj putnika po vrsti; po želji razred i najveći broj presjedanja (maxStops). Uz wait=true odgovor sadrži sve ponude nakon što odgovore svi dobavljači; uz wait=false dobivate searchId i periodički provjeravate GET /v1/flights/search/{searchId} s kursorom dok complete ne postane true.

Svaka ponuda nosi neprozirni offerId, ukupan iznos u vašoj valuti s raščlambom po putniku, slices → segments (prijevoznik, broj leta, vremena, zrakoplov, razred, prtljaga), sažetak uvjeta tarife i vrijeme isteka. Ponude vrijede tijekom trajanja sesije pretraživanja (oko 20 minuta).

Cijena i pravila

POST /v1/flights/offers/{offerId}/price ponovno provjerava tarifu kod dobavljača neposredno prije potvrde i vraća potvrđenu cijenu, pristojbe i podatke o putnicima koje zrakoplovna tvrtka zahtijeva (isprave, datumi rođenja, program vjernosti). GET .../fare-rules vraća tekst o penalima; GET .../ancillaries navodi plaćenu prtljagu i opcije koje možete dodati narudžbi.

Dodatne usluge (dodatna prtljaga)

GET /v1/flights/offers/{offerId}/ancillaries navodi plaćene dodatke koje zrakoplovna tvrtka nudi uz tu tarifu — danas dodatne kvote predane prtljage, svaka s key, brojem komada / težinom i cijenom po putniku. Plaćeni znači da se naplaćuju povrh tarife i obračunavaju s narudžbom, za razliku od uključene prtljage prikazane na samoj ponudi.

Za kupnju dodajte ancillaries[] u POST /v1/flights/orders: jedan unos po dodatku s key i passengerIndex (indeks od 0 u passengers). Obračunavaju se, rezerviraju i izdaju zajedno s narudžbom i pojavljuju se u ukupnim iznosima karata narudžbe. Dodaci se ne mogu dodati narudžbi za koju je karta već izdana; odabir sjedala slijedit će isti obrazac.

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

Izrada narudžbe

POST /v1/flights/orders s offerId, putnicima (imena kao u putovnici, vrsta, datum rođenja, isprava za međunarodne itinerare), kontaktom i neobaveznim ancillaries[] (vidi gore); dodajte Idempotency-Key. Dobivate orderId, PNR zrakoplovne tvrtke, rok za izdavanje karte i status held. U sandboxu narudžba odlazi u testni sustav dobavljača i ništa se ne naplaćuje; u produkciji se rezervira depozit.

Izdavanje karata

POST /v1/flights/orders/{orderId}/issue (obavezan Idempotency-Key) izdaje e-karte i vraća brojeve karata po putniku. Narudžbu možete pročitati u bilo kojem trenutku s GET /v1/flights/orders/{orderId}; status prolazi kroz held → issued → cancelled/refunded.

Poništenje, otkazivanje i povrat novca

GET /v1/flights/orders/{orderId}/refund-quote govori vam što otkazivanje vraća prema pravilima tarife (poništenje isti dan obično je besplatno). POST /v1/flights/orders/{orderId}/cancel ga provodi; povrat se knjiži u knjigu transakcija vašeg depozita, vidljivu na portalu za programere.