API Voli

Calendario tariffe

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 restituisce la tariffa più economica in cache per ogni giorno della rotta, nella tua valuta, indicando quanto è aggiornata la cache. Aggiungi returnFrom / returnTo per i totali di andata e ritorno per coppia di date, e cabin per limitare la classe. Viene servito dalla nostra cache dei prezzi (istantaneo, e non conta mai come ricerca presso i fornitori): usalo per disegnare un calendario o una striscia dei «giorni più economici» prima della ricerca vera e propria.

Ricerca

POST /v1/flights/search con una tratta per la sola andata, due per andata e ritorno, fino a sei per il multi-tratta; numero di passeggeri per tipo; una cabina facoltativa e un numero massimo di scali (maxStops). Con wait=true la risposta contiene tutte le offerte dopo che tutti i fornitori hanno risposto; con wait=false ricevi un searchId ed esegui il polling di GET /v1/flights/search/{searchId} con un cursore finché complete non è true.

Ogni offerta contiene un offerId opaco, il totale nella tua valuta con il dettaglio per passeggero, tratte → segmenti (vettore, numero di volo, orari, aeromobile, cabina, bagaglio), un riepilogo delle condizioni tariffarie e una scadenza. Le offerte sono valide per tutta la durata della sessione di ricerca (circa 20 minuti).

Prezzo e regole

POST /v1/flights/offers/{offerId}/price riconvalida la tariffa con il fornitore subito prima della conferma e restituisce il prezzo confermato, le tasse e i campi passeggero richiesti dalla compagnia aerea (documenti, date di nascita, frequent flyer). GET .../fare-rules restituisce il testo delle penali; GET .../ancillaries elenca i bagagli a pagamento e le opzioni che puoi aggiungere all'ordine.

Servizi accessori (bagaglio extra)

GET /v1/flights/offers/{offerId}/ancillaries elenca gli extra a pagamento che la compagnia aerea offre su quella tariffa: oggi franchigie di bagaglio da stiva aggiuntive, ciascuna con una key, pezzi / peso e un prezzo per passeggero. A pagamento significa che vengono prezzati in aggiunta alla tariffa e fatturati con l'ordine, a differenza della franchigia inclusa indicata nell'offerta stessa.

Per acquistarli, aggiungi ancillaries[] a POST /v1/flights/orders: una voce per ogni extra con la key e il passengerIndex (indice a base 0 in passengers). Vengono prezzati, prenotati ed emessi insieme all'ordine e compaiono nei totali dei biglietti dell'ordine. Non è possibile aggiungere extra a un ordine già emesso; la selezione del posto seguirà lo stesso schema.

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

Crea l'ordine

POST /v1/flights/orders con l'offerId, i passeggeri (nomi come sul passaporto, tipo, data di nascita, documento per gli itinerari internazionali), un contatto e ancillaries[] facoltativi (vedi sopra); aggiungi una Idempotency-Key. Ricevi un orderId, il PNR della compagnia aerea, il termine ultimo di emissione e lo stato held. In sandbox l'ordine arriva al sistema di test del fornitore e non viene addebitato nulla; in produzione l'importo viene riservato sul deposito.

Emetti i biglietti

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key obbligatoria) emette i biglietti elettronici e restituisce i numeri di biglietto per passeggero. Puoi leggere l'ordine in qualsiasi momento con GET /v1/flights/orders/{orderId}; lo stato passa da held → issued → cancelled/refunded.

Void, cancellazione e rimborso

GET /v1/flights/orders/{orderId}/refund-quote indica quanto restituisce una cancellazione secondo le regole tariffarie (un void in giornata di solito è gratuito). POST /v1/flights/orders/{orderId}/cancel la conferma; il rimborso viene accreditato sull'estratto conto del tuo deposito, visibile nel portale sviluppatori.