Demo live

Integrazione API voli

API voli per agenzie e OTA: cercare, prenotare ed emettere

Un'API voli porta sul vostro sito le tariffe aeree in tempo reale e vi permette di creare prenotazioni reali. Questa pagina spiega come funzionano le chiamate, da dove arrivano i contenuti aerei, cosa dovete firmare prima di andare in produzione e come PHPTRAVELS trasforma una o più API voli in un booking engine completo sul vostro dominio.

  • GDS, NDC e consolidatori
  • Dalla ricerca al biglietto al rimborso
  • Connettori pronti
  • La vostra REST API

Che cos'è

Cosa fa davvero un'API voli

Un'API voli è un insieme di servizi web che una compagnia aerea, un GDS o un consolidatore apre a chi vende viaggi. Il vostro sistema invia una richiesta (tratta, date e passeggeri) e riceve offerte con prezzo. Quando il viaggiatore ne sceglie una, altre chiamate confermano il prezzo, creano la prenotazione ed emettono il biglietto.

Le chiamate seguono la vita di un viaggio. I nomi cambiano da fornitore a fornitore, ma ogni API voli copre gli stessi cinque passaggi, e lo standard NDC di IATA dà loro i nomi dei messaggi che oggi usa la maggior parte dei fornitori.

L'API trasporta solo dati. Il modulo di ricerca, la pagina dei risultati, i pagamenti, le fatture e l'assistenza che il vostro team fornisce dopo sono compito della piattaforma di prenotazione, ed è qui che entra in gioco Software di prenotazione voli.

  1. 01

    RicercaAirShopping

    Inviate origine, destinazione, date, cabina e passeggeri. Ricevete offerte con tariffe, tasse, bagagli e famiglie tariffarie.

  2. 02

    QuotazioneOfferPrice

    Ricontrollate l'offerta scelta con il fornitore. Le tariffe cambiano di minuto in minuto, quindi questa chiamata conferma quanto paga il viaggiatore.

  3. 03

    PrenotazioneOrderCreate

    Inviate nomi, contatti e documenti dei passeggeri. Il fornitore crea la prenotazione (un PNR o un order NDC) e blocca i posti.

  4. 04

    EmissioneOrderChange · payment

    Dopo il pagamento, la prenotazione viene emessa come biglietto elettronico, con un numero di biglietto per passeggero e coupon di volo.

  5. 05

    AssistenzaOrderRetrieve · OrderCancel

    Rileggete la prenotazione, cambiate date, aggiungete bagagli o posti, cancellate, annullate o rimborsate secondo le regole tariffarie.

Da dove arrivano le tariffe

Tre tipi di API voli, tre modi di vendere

Ogni API voli che potete firmare rientra in uno di tre gruppi. Cambiano i contenuti, chi può firmare e chi emette il biglietto, per questo la maggior parte delle agenzie finisce per usarne più di uno.

Una piattaforma di prenotazione collegata a una rete GDS, direttamente alle compagnie aeree e a un consolidatore
API GDSAPI NDCAPI consolidatore
Che cos'èAmadeus, Sabre o Travelport: un'unica connessione alle tariffe pubblicate di centinaia di compagnie aeree.Le offerte della compagnia aerea tramite lo standard NDC di IATA, in diretta o tramite un aggregatore.Un grossista che rivende contenuti GDS, NDC e low cost con le proprie tariffe nette.
ContenutiCompagnie di linea e le loro tariffe branded; la copertura low cost varia a seconda del GDS.Le offerte più ricche della compagnia: bundle, servizi ancillari e prezzi dinamici.Spesso il mix più ampio, comprese compagnie low cost e tariffe riservate.
Chi può firmareDi solito agenzie accreditate (IATA, ARC o l'equivalente locale) con un contratto GDS.Agenzie approvate dalla compagnia o dall'aggregatore; alcuni aggregatori accettano anche nuove imprese.La maggior parte delle agenzie e OTA, anche quelle senza un proprio accreditamento.
EmissioneLa vostra agenzia emette il biglietto con il proprio accreditamento.Lo emette la compagnia; l'order viene regolato tramite l'aggregatore o il BSP di IATA.Il consolidatore emette il biglietto per voi, con il suo accreditamento.
PagamentiRegolamento tramite BSP o ARC; commissioni e incentivi dipendono dal vostro contratto.Prezzi e fee della compagnia; alcuni vettori applicano un supplemento alle prenotazioni non NDC.Pagate la tariffa netta del consolidatore da un deposito o una linea di credito e aggiungete il vostro ricarico.
Su PHPTRAVELSAmadeus, Sabre, TravelportDuffelTBO, PKfare, Kiwi, AERTiCKET e altri

Non sapete quale scegliere? Partite con un consolidatore per vendere dal primo giorno, aggiungete un GDS quando siete accreditati e affiancate NDC per le compagnie che riservano lì le offerte migliori. Le guide su Sistema GDS per agenti di viaggio e Sistema di prenotazione voli NDC approfondiscono.

Dentro le chiamate

Cosa passa in un'API voli a ogni passaggio

Una vista semplificata dei dati che la vostra piattaforma invia e riceve. I fornitori reali usano nomi di campo propri e messaggi molto più lunghi; PHPTRAVELS li riconduce tutti allo stesso modello di prenotazione.

Richiesta
 1POST /flights/search 2{ 3  "from": "DXB", "to": "LHR", 4  "date": "2026-11-14", 5  "cabin": "economy", 6  "passengers": { "adults": 2 } 7}
Risposta
 1{ 2  "offers": [{ 3    "id": "OF-7Q2K", 4    "carrier": "EK", "flight": "EK001", 5    "depart": "07:45", "arrive": "11:35", 6    "fare_family": "Standard", 7    "bags": "1 x 23 kg", 8    "total": { "amount": 1284.60, "currency": "USD" }, 9    "expires": "2026-10-09T12:20:00Z"10  }, …]11}

Le offerte scadono. La maggior parte dei fornitori assegna a ogni offerta un limite di tempo, dopo il quale va cercata o quotata di nuovo.

Richiesta
 1POST /flights/price 2{ "offer_id": "OF-7Q2K" }
Risposta
 1{ 2  "offer_id": "OF-7Q2K", 3  "available": true, 4  "total": { "amount": 1284.60, "currency": "USD" }, 5  "fare_rules": { 6    "change": "fee + fare difference", 7    "refund": "not refundable" 8  } 9}

Se la tariffa è cambiata, la piattaforma mostra il nuovo prezzo prima del pagamento invece di prenotare a quello vecchio.

Richiesta
 1POST /flights/book 2{ 3  "offer_id": "OF-7Q2K", 4  "passengers": [{ 5    "type": "adult", 6    "given_name": "SARA", "surname": "KHAN", 7    "born": "1990-04-02", "passport": "…" 8  }, …], 9  "contact": { "email": "…", "phone": "…" }10}
Risposta
 1{ 2  "booking_ref": "6XK2PL", 3  "status": "held", 4  "ticket_time_limit": "2026-10-10T18:00:00Z" 5}

I nomi devono corrispondere al passaporto. Molte compagnie fanno pagare il cambio nome o non lo consentono affatto.

Richiesta
 1POST /flights/ticket 2{ "booking_ref": "6XK2PL", "payment": "…" }
Risposta
 1{ 2  "booking_ref": "6XK2PL", 3  "status": "ticketed", 4  "tickets": [ 5    { "passenger": 1, "number": "176-2400000001" }, 6    { "passenger": 2, "number": "176-2400000002" } 7  ] 8}

Finché non viene emessa, una prenotazione in opzione si cancella automaticamente alla scadenza del termine di emissione.

Dati illustrativi, semplificati

Pronti in PHPTRAVELS

Connettori API voli da attivare con le vostre chiavi

Questi fornitori aerei sono già collegati al modulo voli di PHPTRAVELS. Firmate con il fornitore, inserite le credenziali nel pannello, provate nel suo sandbox e andate in produzione. L'elenco è quello aggiornato della nostra directory delle integrazioni.

Il vostro fornitore non c'è? Si può aggiungere qualsiasi API voli documentata, e il codice sorgente è vostro. Vedete Integrazione API personalizzata o la Lista fornitori XML API per il travel completa.

Prima della prima prenotazione

Cosa serve oltre all'API

La connessione tecnica è la parte veloce. Ecco cosa chiedono i fornitori prima di passare il vostro account in produzione.

  • Un contratto con il fornitore

    Ogni API voli richiede un accordo con il GDS, la compagnia aerea, l'aggregatore o il consolidatore. Le credenziali arrivano con il contratto, non dal fornitore del software.

  • Accreditamento o un partner di emissione

    Per emettere biglietti in proprio serve IATA, ARC o un equivalente locale. Senza, li emette un consolidatore per voi.

  • Certificazione

    La maggior parte dei fornitori testa il vostro flusso di prenotazione nel sandbox (ricerca, prenotazione, emissione, cancellazione) prima di dare l'accesso in produzione.

  • Un modo per pagare il fornitore

    Regolamento BSP o ARC, un deposito presso un consolidatore o pagamenti con carta addebitati direttamente dalla compagnia.

  • Regole tariffarie e condizioni

    Condizioni chiare su cambi, rimborsi e bagagli sul vostro sito, prese dalle regole tariffarie del fornitore, così il viaggiatore sa cosa ha acquistato.

  • Qualcuno che gestisca le prenotazioni

    Cambi d'orario, correzioni dei nomi, annullamenti e rimborsi continuano ad arrivare dopo la vendita. Decidete chi se ne occupa.

API e booking engine

L'API porta le tariffe. La piattaforma le trasforma in vendite.

Collegare un'API voli direttamente a un sito lascia ancora da fare gran parte del lavoro. Ecco la divisione tra ciò che dà l'API del fornitore e ciò che aggiunge PHPTRAVELS.

Un'API voli vi dà

  • Offerte e tariffe per una tratta e una data
  • Una verifica del prezzo e le regole tariffarie
  • Un codice di prenotazione (PNR o order)
  • I numeri di biglietto dopo l'emissione
  • Chiamate di modifica e cancellazione

PHPTRAVELS aggiunge

  • Modulo di ricerca, risultati, filtri e checkout nelle vostre lingue
  • Più fornitori interrogati insieme, duplicati uniti
  • Ricarichi, commissioni e wallet per agenti B2B
  • Pagamenti con carta tramite il vostro gateway
  • Biglietti elettronici, fatture ed email nella lingua del viaggiatore
  • Code di prenotazioni, annullamento, rimborso e riemissione nel pannello

Scopri come funziona ogni parte, funzione per funzione, nella pagina Voli.

Per sviluppatori

La vostra API voli sopra tutti i fornitori

PHPTRAVELS normalizza ogni fornitore aereo collegato in un unico modello di prenotazione. Le vostre app mobili, i partner e gli strumenti interni dialogano così con una sola REST API invece che con quella di ciascun fornitore.

La REST API e la sua documentazione sono incluse nel piano Enterprise. Confrontate i piani su Prezzi o leggete la documentazione per sviluppatori.

  • Un formato per tutti i fornitoriLe offerte da fonti GDS, NDC e consolidatori escono con la stessa struttura, così la vostra app non gestisce mai i formati dei fornitori.
  • WebhookGli eventi di prenotazione, emissione e cancellazione vengono inviati ai vostri sistemi nel momento in cui avvengono.
  • Codice sorgente inclusoSelf-hosted con il codice sorgente completo, così i vostri sviluppatori possono estendere l'API o aggiungere un fornitore.

Approfondimenti

Guide sulle API voli

Guardate un'API voli all'opera in un vero booking engine

Cercate, prenotate e gestite voli nella demo dal vivo, poi parlateci dei fornitori che intendete firmare.

Provate la demo dal vivoChiedeteci dei vostri fornitori

Domande frequenti

API voli: le domande delle agenzie

Contatta il team vendite

Un'API voli è un insieme di servizi web che permette a un sito di viaggi di cercare tariffe aeree, verificare i prezzi, creare prenotazioni ed emettere biglietti in tempo reale. GDS, compagnie aeree (tramite NDC) e consolidatori ne offrono ciascuno una.

Alcuni fornitori offrono un sandbox gratuito per i test, e alcune API di metasearch restituiscono prezzi senza prenotazione. Per vendere biglietti serve sempre un accordo commerciale con un GDS, una compagnia aerea, un aggregatore o un consolidatore.

Non sempre. L'accreditamento serve per emettere biglietti in proprio tramite un GDS. Senza, un'API consolidatore vi permette di vendere e il consolidatore emette i biglietti con il suo accreditamento.

Di solito un consolidatore, perché accetta agenzie senza accreditamento e include le compagnie low cost. Aggiungete una connessione GDS o NDC man mano che i volumi crescono.

Un'API GDS dà accesso alle tariffe pubblicate di molte compagnie con un'unica connessione. Un'API NDC offre le offerte proprie di una compagnia, con bundle ed extra, nel formato NDC di IATA, in diretta o tramite un aggregatore.

Sì. PHPTRAVELS interroga insieme tutti i fornitori aerei collegati, unisce i voli duplicati e mantiene la tariffa migliore, così il viaggiatore vede un'unica lista.

No. Firmate con ciascun fornitore e inserite le vostre credenziali nel pannello. PHPTRAVELS fornisce la piattaforma di prenotazione e i connettori pronti.

Con un connettore pronto, la parte tecnica si riduce a inserire le credenziali e fare i test. Gran parte del tempo va nel contratto e nella certificazione del fornitore, che dipendono da lui.

Sì. Con il piano Enterprise, la REST API di PHPTRAVELS espone ricerca e prenotazione di tutti i fornitori collegati in un unico formato, con webhook per gli eventi di prenotazione.

Continua a esplorare

Altro sulla piattaforma