Lentorajapinta

Hintakalenteri

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 palauttaa reitin halvimman välimuistissa olevan hinnan päivittäin valuutassasi sekä tiedon välimuistin tuoreudesta. Lisää returnFrom / returnTo saadaksesi meno-paluun kokonaishinnat päivämääräpareittain ja cabin rajataksesi matkustusluokan. Tiedot tulevat hintavälimuististamme – välittömästi, eikä kutsu koskaan laske toimittajahauksi – joten käytä sitä kalenterin tai ”halvimmat päivät” -nauhan piirtämiseen ennen varsinaista hakua.

Haku

POST /v1/flights/search yhdellä osuudella yhdensuuntaiselle matkalle, kahdella meno-paluulle ja enintään kuudella monikohdematkalle; matkustajamäärät tyypeittäin; valinnaisesti matkustusluokka ja välilaskujen enimmäismäärä (maxStops). Kun wait=true, vastaus sisältää kaikki tarjoukset, kun kaikki toimittajat ovat vastanneet; kun wait=false, saat searchId:n ja kyselet GET /v1/flights/search/{searchId} kursorin kanssa, kunnes complete on true.

Jokaisessa tarjouksessa on läpinäkymätön offerId, kokonaissumma valuutassasi matkustajakohtaisine erittelyineen, osuudet → segmentit (lentoyhtiö, lennon numero, ajat, konetyyppi, matkustusluokka, matkatavarat), yhteenveto hintaehdoista ja voimassaolon päättyminen. Tarjoukset ovat voimassa hakuistunnon ajan (noin 20 minuuttia).

Hinta ja säännöt

POST /v1/flights/offers/{offerId}/price vahvistaa hinnan uudelleen toimittajalta juuri ennen sitoutumista ja palauttaa vahvistetun hinnan, verot sekä lentoyhtiön vaatimat matkustajakentät (asiakirjat, syntymäajat, kanta-asiakasnumero). GET .../fare-rules palauttaa sakkoehtojen tekstin; GET .../ancillaries listaa maksulliset matkatavarat ja vaihtoehdot, jotka voit lisätä tilaukseen.

Lisäpalvelut (lisämatkatavarat)

GET /v1/flights/offers/{offerId}/ancillaries listaa maksulliset lisät, joita lentoyhtiö tarjoaa kyseisellä hinnalla – tällä hetkellä ylimääräiset ruumamatkatavarakiintiöt, joilla kullakin on key, kappalemäärä / paino ja hinta matkustajaa kohden. Maksullinen tarkoittaa, että ne hinnoitellaan lipun hinnan päälle ja laskutetaan tilauksen yhteydessä, toisin kuin itse tarjouksessa näkyvä sisältyvä kiintiö.

Ostaaksesi niitä lisää ancillaries[] kutsuun POST /v1/flights/orders: yksi merkintä lisää kohden, jossa key ja passengerIndex (0-pohjainen indeksi passengers-taulukkoon). Ne hinnoitellaan, varataan ja kirjoitetaan yhdessä tilauksen kanssa ja näkyvät tilauksen lippusummissa. Lisiä ei voi lisätä tilaukseen, jonka liput on jo kirjoitettu; istuinvalinta tulee noudattamaan samaa mallia.

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

Luo tilaus

POST /v1/flights/orders, jossa offerId, matkustajat (nimet kuten passissa, tyyppi, syntymäaika, asiakirja kansainvälisille matkoille), yhteystiedot ja valinnaiset ancillaries[] (ks. yllä); lisää Idempotency-Key. Saat orderId:n, lentoyhtiön PNR:n, lipunkirjoituksen määräajan ja tilan held. Sandboxissa tilaus menee toimittajan testijärjestelmään eikä mitään veloiteta; tuotannossa summa varataan talletuksesta.

Kirjoita liput

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key pakollinen) kirjoittaa sähköiset liput ja palauttaa lippunumerot matkustajittain. Voit lukea tilauksen milloin tahansa kutsulla GET /v1/flights/orders/{orderId}; tila etenee held → issued → cancelled/refunded.

Mitätöinti, peruutus ja hyvitys

GET /v1/flights/orders/{orderId}/refund-quote kertoo, mitä peruutus palauttaa hintasääntöjen mukaan (saman päivän mitätöinti on yleensä maksuton). POST /v1/flights/orders/{orderId}/cancel vahvistaa sen; hyvitys kirjataan talletuksesi tilitapahtumiin, jotka näkyvät kehittäjäportaalissa.