Repülőjegy-API

Viteldíjnaptár

A GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 napi bontásban visszaadja az útvonal gyorsítótárban tárolt legolcsóbb viteldíját az Ön pénznemében, a gyorsítótár frissességével együtt. Adja hozzá a returnFrom / returnTo paramétert a dátumpáronkénti oda-vissza végösszegekhez, a cabin paramétert pedig az osztály szűkítéséhez. Az adatot az árgyorsítótárunkból szolgáljuk ki — azonnali, és sosem számít beszállítói keresésnek —, így a valódi keresés előtt naptár vagy „legolcsóbb napok” sáv megjelenítésére használhatja.

Keresés

POST /v1/flights/search egy slice-szal egyirányú, kettővel oda-vissza, legfeljebb hattal többállomásos útra; utasszám típusonként; opcionálisan kabinosztály és az átszállások maximális száma (maxStops). wait=true esetén a válasz minden ajánlatot tartalmaz, miután az összes beszállító válaszolt; wait=false esetén egy searchId-t kap, és a GET /v1/flights/search/{searchId} végpontot kérdezi le cursorral, amíg a complete értéke true nem lesz.

Minden ajánlat tartalmaz egy átlátszatlan offerId-t, a végösszeget az Ön pénznemében utasonkénti bontással, slices → segments adatokat (légitársaság, járatszám, időpontok, repülőgép, kabinosztály, poggyász), a viteldíjfeltételek összefoglalóját és egy lejárati időt. Az ajánlatok a keresési munkamenet élettartama alatt (kb. 20 percig) érvényesek.

Ár és szabályok

A POST /v1/flights/offers/{offerId}/price közvetlenül a véglegesítés előtt újraérvényesíti a viteldíjat a beszállítónál, és visszaadja a megerősített árat, az adókat és a légitársaság által megkövetelt utasadatokat (okmányok, születési dátumok, törzsutas-szám). A GET .../fare-rules a kötbérfeltételek szövegét adja vissza; a GET .../ancillaries felsorolja a rendeléshez hozzáadható fizetős poggyászokat és opciókat.

Kiegészítő szolgáltatások (többletpoggyász)

A GET /v1/flights/offers/{offerId}/ancillaries felsorolja a légitársaság által az adott viteldíjhoz kínált fizetős extrákat — jelenleg többlet feladott poggyászkeretet, mindegyiket key értékkel, darabszámmal / súllyal és utasonkénti árral. A fizetős azt jelenti, hogy a viteldíjon felül árazzuk és a rendeléssel együtt számlázzuk, szemben az ajánlaton feltüntetett, már benne foglalt poggyászkerettel.

Megvásárlásukhoz adja hozzá az ancillaries[] tömböt a POST /v1/flights/orders kéréshez: extránként egy bejegyzés a key és a passengerIndex értékkel (0-tól számozva a passengers tömbben). Az extrákat a rendeléssel együtt árazzuk, foglaljuk és állítjuk ki, és megjelennek a rendelés jegyösszesítőiben. Már kiállított jegyű rendeléshez extra nem adható hozzá; az ülőhelyválasztás ugyanezt a mintát fogja követni.

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

Rendelés létrehozása

POST /v1/flights/orders az offerId-vel, az utasokkal (útlevél szerinti név, típus, születési dátum, nemzetközi útvonalaknál okmány), egy kapcsolattartóval és opcionális ancillaries[] tömbbel (lásd fent); adjon hozzá Idempotency-Key fejlécet. Visszakapja az orderId-t, a légitársasági PNR-t, a jegykiállítási határidőt és a held állapotot. A tesztkörnyezetben a rendelés a beszállító tesztrendszerébe kerül, és semmit sem terhelünk; éles környezetben a letétből zárolunk.

Jegykiállítás

A POST /v1/flights/orders/{orderId}/issue (Idempotency-Key kötelező) e-jegyeket állít ki, és utasonként visszaadja a jegyszámokat. A rendelést bármikor lekérheti a GET /v1/flights/orders/{orderId} végponttal; az állapot a held → issued → cancelled/refunded sorrendben változik.

Érvénytelenítés, lemondás és visszatérítés

A GET /v1/flights/orders/{orderId}/refund-quote megmutatja, mennyit térít vissza egy lemondás a viteldíjszabályok szerint (az aznapi érvénytelenítés általában díjmentes). A POST /v1/flights/orders/{orderId}/cancel véglegesíti; a visszatérítés a letéti főkönyvébe kerül, és a fejlesztői portálon látható.