API za letove

Kalendar tarifa

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 vraća najjeftiniju keširanu tarifu po danu za rutu, u vašoj valuti, uz podatak koliko je keš svež. Dodajte returnFrom / returnTo za povratne ukupne iznose po paru datuma, i cabin za ograničenje klase. Servira se iz našeg keša cena — trenutno, i nikada se ne računa kao pretraga kod dobavljača — pa ga koristite da iscrtate kalendar ili traku „najjeftinijih dana” pre prave pretrage.

Pretraga

POST /v1/flights/search sa jednom deonicom za jednosmerni let, dve za povratni, do šest za više gradova; broj putnika po tipu; opciona klasa i najveći broj presedanja (maxStops). Sa wait=true odgovor sadrži sve ponude kada svi dobavljači odgovore; sa wait=false dobijate searchId i periodično pozivate GET /v1/flights/search/{searchId} sa kursorom dok complete ne bude true.

Svaka ponuda nosi neprozirni offerId, ukupan iznos u vašoj valuti sa raspodelom po putniku, deonice → segmente (prevoznik, broj leta, vremena, avion, klasa, prtljag), sažetak uslova tarife i rok važenja. Ponude važe tokom trajanja sesije pretrage (oko 20 minuta).

Cena i pravila

POST /v1/flights/offers/{offerId}/price ponovo proverava tarifu kod dobavljača neposredno pre obavezivanja i vraća potvrđenu cenu, takse i polja o putnicima koja avio-kompanija zahteva (dokumenti, datumi rođenja, frequent flyer). GET .../fare-rules vraća tekst o penalima; GET .../ancillaries navodi plaćeni prtljag i opcije koje možete dodati porudžbini.

Dodatne usluge (dodatni prtljag)

GET /v1/flights/offers/{offerId}/ancillaries navodi dodatke koji se naplaćuju, a koje avio-kompanija nudi za tu tarifu — za sada dodatne količine predatog prtljaga, svaku sa ključem, brojem komada / težinom i cenom po putniku. Naplativi znači da se obračunavaju povrh tarife i naplaćuju uz porudžbinu, za razliku od uključenog prtljaga prikazanog na samoj ponudi.

Da biste ih kupili, dodajte ancillaries[] u POST /v1/flights/orders: jedan unos po dodatku sa key i passengerIndex (indeks od 0 u nizu passengers). Obračunavaju se, rezervišu i izdaju zajedno sa porudžbinom i pojavljuju se u ukupnim iznosima karata porudžbine. Dodaci se ne mogu dodati porudžbini za koju je karta već izdata; izbor sedišta pratić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 }]
}

Kreiranje porudžbine

POST /v1/flights/orders sa offerId, putnicima (imena kao u pasošu, tip, datum rođenja, dokument za međunarodne itinerere), kontaktom i opcionim ancillaries[] (videti iznad); dodajte Idempotency-Key. Dobijate orderId, PNR avio-kompanije, rok za izdavanje karte i status held. U sandbox okruženju porudžbina završava u test sistemu dobavljača i ništa se ne naplaćuje; u produkciji se depozit rezerviše.

Izdavanje karata

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key obavezan) izdaje elektronske karte i vraća brojeve karata po putniku. Porudžbinu u bilo kom trenutku pročitajte sa GET /v1/flights/orders/{orderId}; status prolazi kroz held → issued → cancelled/refunded.

Poništavanje, otkazivanje i povraćaj

GET /v1/flights/orders/{orderId}/refund-quote govori šta otkazivanje vraća prema pravilima tarife (poništavanje istog dana je obično besplatno). POST /v1/flights/orders/{orderId}/cancel ga izvršava; povraćaj stiže u knjigu prometa vašeg depozita i vidljiv je na portalu za programere.