Demo live

Guida

Cos'è l'integrazione API, spiegato per le aziende di viaggi

Un'integrazione API è una connessione che permette a due sistemi software di scambiare dati e attivare azioni senza che una persona debba ridigitare nulla. Questa guida spiega come funziona, seguendo una prenotazione alberghiera che passa tra un viaggiatore, una piattaforma di prenotazione, l'API di un fornitore e un gateway di pagamento.

  • Una richiesta, una risposta
  • REST, XML, SOAP e webhook
  • Una prenotazione seguita in quattro sistemi
  • Come si testano le integrazioni

La definizione

Cos'è l'integrazione API, in parole semplici

API sta per application programming interface: l'insieme di regole che un sistema pubblica perché altri software possano dialogare con esso. L'integrazione API è il lavoro di collegare la vostra piattaforma a una di queste interfacce, in modo che i dati circolino e le azioni avvengano in automatico.

Nel travel quella piattaforma è di solito un sistema di prenotazione come Software di prenotazione viaggi, e l'interfaccia appartiene a un fornitore, a un gateway di pagamento o a uno strumento aziendale. La nostra pagina Integrazione API di viaggio spiega come PHPTRAVELS realizza queste connessioni, e Tutte le integrazioni elenca i fornitori già collegati.

  • Scambiare dati

    Tariffe, disponibilità, dati dei clienti e aggiornamenti di stato passano tra i sistemi in un formato strutturato.

  • Automatizzare le azioni

    Cercare, prenotare, pagare, cancellare e riconciliare avvengono come richieste, non come passaggi che qualcuno ripete a mano.

  • Tracciare gli esiti

    Ogni chiamata porta un riferimento, quindi una prenotazione fallita può essere ricondotta alla richiesta che l'ha causata.

Richiesta

POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{  "city": "DXB",  "check_in": "2026-11-12",  "check_out": "2026-11-14",  "guests": 2,  "currency": "USD"}

Risposta

HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{  "hotel": "Palm Marina Hotel",  "room": "Deluxe, 2 adults",  "rate": { "amount": 438.00, "currency": "USD" },  "refundable": true,  "rate_key": "rk_19d2c7"}
Chiamata di esempio a un fornitore alberghiero immaginario. Nomi dei campi, endpoint e importi variano da un fornitore all'altro.

Anatomia di una chiamata API

  1. 1

    Endpoint e metodo

    L'indirizzo dell'operazione e il verbo usato su di esso: POST su availability significa cercare camere.

  2. 2

    Autenticazione

    Una chiave, un token o una firma dimostra chi sta chiamando. I fornitori rilasciano credenziali separate per sandbox e produzione.

  3. 3

    Payload

    L'input strutturato: città, date, ospiti e valuta. La documentazione del fornitore definisce ogni campo.

  4. 4

    Codice di stato

    Un numero che dice com'è andata la chiamata: 200 è successo, 4xx un problema nella richiesta, 5xx un problema dal lato del fornitore.

  5. 5

    ID richiesta

    Un identificativo che entrambe le parti conservano. Quando il supporto chiede cosa è successo a una prenotazione, è questo che cerca.

  6. 6

    Corpo della risposta

    La risposta nel formato del fornitore, che la vostra piattaforma mappa nelle proprie camere, tariffe e politiche.

Una prenotazione, quattro sistemi

Cosa fa l'integrazione API durante una prenotazione alberghiera

Seguite un soggiorno di due notti dalla ricerca al voucher. Ogni freccia è una chiamata API; il viaggiatore vede solo la prima e l'ultima.

  1. 01ViaggiatorePiattaforma di prenotazioneCerca hotel a Dubai, due notti, due ospiti
  2. 02Piattaforma di prenotazioneAPI del fornitoreRichiesta di disponibilità con date, ospiti e valuta
  3. 03API del fornitorePiattaforma di prenotazioneCamere, tariffe, politiche e una chiave tariffaria
  4. 04Piattaforma di prenotazioneViaggiatoreRisultati mostrati con il vostro markup e la vostra valuta applicati
  5. 05Piattaforma di prenotazioneAPI del fornitoreRiverifica del prezzo sulla chiave tariffaria scelta prima del pagamento
  6. 06Piattaforma di prenotazioneGateway di pagamentoAutorizzazione del pagamento per il totale
  7. 07Gateway di pagamentoPiattaforma di prenotazioneAutorizzato, webhook firmato ricevuto
  8. 08Piattaforma di prenotazioneAPI del fornitoreRichiesta di prenotazione con i dati dell'ospite
  9. 09API del fornitorePiattaforma di prenotazioneNumero di conferma e condizioni di cancellazione
  10. 10Piattaforma di prenotazioneViaggiatoreVoucher, fattura e riferimento della prenotazione

La piattaforma al centro è dove vive l'integrazione API: traduce tra lo schermo del viaggiatore e il formato di ogni fornitore, e conserva ogni riferimento.

La stessa sequenza serve Software di prenotazione voli con un GDS, Software per tour operator con un fornitore di attività e Integrazione gateway di pagamento con qualsiasi gateway; cambiano solo i nomi dei campi.

Stili di integrazione

REST, XML, SOAP, webhook e GraphQL

I fornitori pubblicano le loro interfacce in stili diversi. Lo stile è deciso dalla documentazione del fornitore, non dalle preferenze, quindi una piattaforma di viaggi deve parlarli tutti.

  • REST e JSON

    JSON
    Formato dati
    Documenti JSON
    Trasporto
    Metodi HTTP: GET, POST, PUT, DELETE
    Tipico nel travel
    API più recenti per voli, hotel, attività e pagamenti
    Punto di forza
    Payload compatti e ampia disponibilità di strumenti per sviluppatori
    Attenzione a
    Specifica poco rigida; ogni fornitore interpreta REST a modo suo

  • XML e SOAP

    XML
    Formato dati
    Documenti XML, spesso con uno schema rigoroso
    Trasporto
    HTTP POST con una busta SOAP o XML semplice
    Tipico nel travel
    GDS, bedbank e sistemi alberghieri e di tour consolidati
    Punto di forza
    Contratti formali, firme e definizioni di servizio
    Attenzione a
    Messaggi prolissi e parsing più pesante

  • Webhook

    EVENT
    Formato dati
    JSON o XML, inviati dall'altra parte
    Trasporto
    HTTP POST verso un URL che registrate
    Tipico nel travel
    Esiti dei pagamenti, cambi di stato delle prenotazioni, aggiornamenti di emissione biglietti
    Punto di forza
    Nessun polling; la vostra piattaforma viene avvisata quando succede qualcosa
    Attenzione a
    Le firme vanno verificate e le ripetizioni gestite

  • GraphQL

    QUERY
    Formato dati
    JSON, modellato dalla query che inviate
    Trasporto
    Un unico endpoint HTTP
    Tipico nel travel
    Alcune piattaforme di distribuzione più recenti e API interne
    Punto di forza
    Chiedete esattamente i campi che vi servono
    Attenzione a
    Il supporto dei fornitori nel travel è ancora poco diffuso

Integrazione API e sviluppo API a confronto

Integrazione API

Collega il vostro prodotto a un'interfaccia già esistente. Il fornitore possiede l'API; voi costruite il client, la mappatura e le regole intorno a essa.

Sviluppo API

Crea un'interfaccia che altri sistemi usano per collegarsi al vostro prodotto, come un'API B2B che gli strumenti dei vostri agenti possono chiamare. Voi possedete il contratto e le sue versioni.

Molti progetti travel hanno bisogno di entrambi: la piattaforma integra i fornitori da un lato e pubblica la propria API verso agenti e partner dall'altro.

Prima e dopo

Cosa cambia quando i sistemi sono integrati

Gli stessi cinque passaggi di una prenotazione, fatti a mano sui portali dei fornitori e fatti tramite integrazione API.

Ricerca

Senza integrazioneManuale

Un agente apre ogni portale fornitore e copia i prezzi in un preventivo.

Con integrazione APIAutomatico

Una sola ricerca si distribuisce a tutti i fornitori collegati e restituisce un unico elenco.

Prezzo

Senza integrazioneManuale

Il markup viene aggiunto in un foglio di calcolo; la tariffa può essere cambiata quando il preventivo viene inviato.

Con integrazione APIAutomatico

Markup, tasse e regole valutarie si applicano al momento della risposta; la tariffa viene riverificata prima del pagamento.

Prenotazione

Senza integrazioneManuale

I dati dell'ospite vengono ridigitati nel portale del fornitore; gli errori di battitura diventano errori di prenotazione.

Con integrazione APIAutomatico

I dati vengono inviati una volta, convalidati e salvati con la conferma del fornitore.

Pagamento

Senza integrazioneManuale

Il pagamento viene incassato separatamente e abbinato alla prenotazione in seguito.

Con integrazione APIAutomatico

Autorizzazione, incasso e rimborso sono legati al riferimento della prenotazione.

Assistenza

Senza integrazioneManuale

Cancellazioni e modifiche significano un altro accesso e un'altra email.

Con integrazione APIAutomatico

Modifiche e cancellazioni passano dalla stessa connessione e aggiornano il record.

Dove compare l'integrazione API in una piattaforma di viaggi

Vocabolario

Termini che incontrerete nella documentazione API

Dodici parole che compaiono nel portale sviluppatori di quasi ogni fornitore, definite nel modo in cui si usano nel travel.

  • API

    Application programming interface: le regole pubblicate per dialogare con un sistema.

  • Autenticazione

    Dimostrare chi sta chiamando, con una chiave API, un bearer token, una firma o un indirizzo IP approvato.

  • Certificazione

    La revisione della vostra integrazione da parte del fornitore prima del rilascio delle credenziali di produzione.

  • Endpoint

    Un indirizzo per un'operazione, come cercare, prenotare o cancellare.

  • Idempotenza

    Inviare due volte la stessa richiesta produce un solo risultato, il che evita prenotazioni e addebiti duplicati.

  • Mappatura

    Tradurre campi, codici e nomi del fornitore nel modello dati della vostra piattaforma.

  • Payload

    I dati trasportati in una richiesta o in una risposta, di solito JSON o XML.

  • Limite di chiamate

    Il numero di chiamate che un fornitore consente al secondo o al giorno prima di iniziare a rifiutarle.

  • Richiesta e risposta

    Una chiamata: la vostra piattaforma chiede, il fornitore risponde, ed entrambe le parti la registrano.

  • Sandbox

    Un ambiente di test con inventario fittizio e carte di prova dove nulla viene davvero prenotato o addebitato.

  • Codice di stato

    Il numero HTTP che riassume il risultato: 200 successo, 401 non autorizzato, 429 limite di chiamate, 500 errore del fornitore.

  • Webhook

    Una chiamata nella direzione opposta: il fornitore o il gateway avvisa la vostra piattaforma quando si verifica un evento.

Test e definizione dell'ambito

Come si testa un'integrazione API travel prima della messa in produzione

Un'integrazione è finita solo quando i percorsi d'errore si comportano correttamente. Un ciclo di test sulla sandbox del fornitore copre i casi qui sotto prima della certificazione e del passaggio alle credenziali di produzione.

esegui test di integrazione

sandbox del fornitore, nove casi

  • OK: Autenticazione con credenziali valide e scadute
  • OK: Richiesta non valida rifiutata con un errore leggibile
  • OK: Timeout del fornitore gestito senza prenotazioni sospese
  • OK: Limite di chiamate rispettato e nuovo tentativo dopo l'attesa
  • OK: Variazione di prezzo rilevata alla riverifica e mostrata prima del pagamento
  • OK: L'invio duplicato restituisce la prima prenotazione, non una seconda
  • OK: Cancellazione applicata e penali calcolate
  • OK: Rimborso emesso sul pagamento originale
  • OK: Riferimenti di prenotazione, pagamento e fornitore riconciliati

Tutti i casi superati, pronto per la certificazione

Cosa serve per definire l'ambito

  1. 1Accordo con il fornitore, documentazione e credenziali sandbox
  2. 2Mercati, valute, prodotti e ruoli utente
  3. 3Ambito di ricerca, prenotazione, modifica, cancellazione e rimborso
  4. 4Requisiti di certificazione e procedura di accesso alla produzione

Pronti a collegare un fornitore

PHPTRAVELS integra fornitori, gateway e strumenti aziendali in una piattaforma self-hosted consegnata con il codice sorgente. Consultate Prezzi per i tre piani a pagamento unico, oppure chiedeteci di una API specifica.

Richiedi una demoParla con noi

Continua a leggere

Domande

Domande sull'integrazione API, con risposta

Risposte brevi alle domande che le persone pongono prima del primo progetto di integrazione.

Contatta il team vendite

L'integrazione API è una connessione che permette a due sistemi software di scambiare dati e attivare azioni in automatico. Un sistema invia una richiesta strutturata, l'altro restituisce una risposta strutturata, ed entrambi seguono regole concordate per sicurezza e dati.

Nel travel collega una piattaforma di prenotazione con fornitori di voli, hotel, tour o auto, gateway di pagamento e strumenti aziendali. Supporta ricerca, validazione dei prezzi, prenotazione, cancellazione, rimborsi e riconciliazione senza ridigitare nulla.

REST è uno stile architetturale che di solito scambia JSON su HTTP. XML è un formato dati ancora comune tra GDS e bedbank, spesso incapsulato in SOAP. Il contratto e la documentazione del fornitore decidono quale usare.

Dipende dall'accesso al fornitore, dagli endpoint in ambito, dalla certificazione, dalle regole di mappatura e dai casi limite della prenotazione. Una stima affidabile segue una revisione della documentazione, delle credenziali e dei flussi di lavoro necessari.

Testate autenticazione, richieste valide e non valide, timeout, limiti di chiamate, variazioni di prezzo, invii duplicati, cancellazioni, rimborsi e riconciliazione. In produzione, ogni richiesta dovrebbe essere riconducibile a un riferimento di prenotazione.

No. L'integrazione collega il vostro prodotto a un'API esistente; lo sviluppo crea un'interfaccia a cui altri si collegano. Le piattaforme di viaggi spesso hanno bisogno di entrambi: fornitori integrati da un lato e un'API B2B pubblicata verso i partner dall'altro.

Continua a esplorare

Altro sulla piattaforma