Confronto tra API di viaggio: valuta gli assi, non i fornitori

Hai tre presentazioni di fornitori aperte in tre schede. Ognuna ha una slide con un lungo elenco di compagnie aeree, una slide con il numero di hotel, una sandbox, REST e JSON, e un indirizzo email di supporto. Costruisci un foglio di calcolo, metti una spunta in ogni cella, e il foglio finisce in pareggio. È la fine abituale di un confronto tra API di viaggio fatto come checklist di funzionalità, ed è la fine sbagliata: le differenze che decideranno il tuo prossimo anno emergono solo dopo il go-live. Sulla prenotazione andata a buon fine presso il fornitore ma scaduta in timeout dalla tua parte, sul rimborso che nessuno riesce a lavorare, sulla compagnia che era nell'elenco ma non si può emettere attraverso questa via.
Questo articolo è per lo sviluppatore o il responsabile tecnico che deve prendere quella decisione e difenderla più avanti. Non classifica i fornitori. Ti dà gli assi su cui confrontarli, un piano di trial che spende il suo tempo sugli errori, e poche domande che ti dicono in fretta se stai parlando con un fornitore o con il rivenditore del fornitore di qualcun altro.
Perché la checklist delle funzionalità finisce sempre in pareggio
Una checklist chiede se una capacità esiste. Quasi ogni API di viaggio può rispondere sì a quasi ogni riga, perché le righe sono scritte al livello della pagina marketing: ricerca, prezzo, prenotazione, cancellazione, emissione, webhook, sandbox. La domanda che le distingue non è se cancel esiste, ma cosa succede quando lo chiami su una prenotazione già emessa dodici ore prima della partenza, su una tariffa con penale, attraverso una via in cui il contenuto arriva da terzi. Una checklist non ha una colonna per questo.
C'è un secondo problema. Chi compila la checklist, di solito, è il fornitore stesso. Stai dando un voto alla sua autodescrizione.
Un confronto tra API di viaggio costruito sugli assi, non sui fornitori
Sostituisci la griglia fornitore-per-funzionalità con assi che valuti tu, sulla base di prove raccolte durante il trial. La tabella qui sotto è quella che useremmo noi. Puoi pesare le righe in modo diverso — un'attività solo alberghiera si preoccupa meno dell'emissione — e conviene discuterla prima di adottarla.
| Asse | Cosa chiede una checklist | Cosa scoprire davvero | Come suona una risposta debole |
|---|---|---|---|
| Copertura | Quante compagnie e quanti hotel? | Quanti si possono cercare, prenotare E emettere o confermare tramite questa API, nei tuoi mercati | Un unico numero grande, senza dettaglio |
| Profondità | Esiste un endpoint di cancellazione? | Quali azioni post-prenotazione sono automatizzate per ogni fonte di contenuto: void, rimborso, riemissione, correzione del nome, servizi ancillari | «Se ne occupa il nostro team operativo» |
| Integrità del prezzo | Il prezzo è in tempo reale? | Quanto spesso il prezzo alla prenotazione differisce da quello della ricerca, e come l'API te lo comunica | «I prezzi sono sempre live» |
| Semantica degli errori | Gli errori sono documentati? | Se un errore ti dice in che stato si trova la prenotazione, non solo che qualcosa è andato storto | Un unico codice generico per ogni errore |
| Idempotenza | — | Se una chiamata di prenotazione ripetuta può creare una seconda prenotazione | Silenzio, poi «non ci è mai capitato» |
| Fornitore contrattuale | — | Di chi è il contratto, il codice IATA, il BSP attraverso cui passa il biglietto | «Lavoriamo con tutti i principali GDS» |
| Accesso e supporto | C'è una sandbox? | Chi risponde quando un PNR reale è bloccato, e con che rapidità | Un modulo di ticket e nessun referente con un nome |
Due di quelle righe non hanno alcuna domanda in checklist. Non è un caso: sono le righe che costano di più quando vanno male, e quelle che una presentazione commerciale ha meno probabilità di menzionare spontaneamente.
Copertura non vuol dire profondità
L'elenco delle compagnie aeree è la slide più fuorviante di qualsiasi presentazione. Una lista di diverse centinaia di vettori può significare cose diverse, e solo una è quella che ti serve.
Alcuni di quei vettori arrivano tramite un GDS e si possono prenotare ed emettere da capo a fondo. Altri arrivano via connessioni NDC, dove la ricerca può funzionare bene ma l'assistenza dopo la prenotazione — modifiche, rimborsi parziali, aggiunta di un bagaglio — può essere ancora manuale per quella compagnia. Altri ancora sono low cost il cui contenuto è aggregato da un altro rivenditore: puoi mostrarli, a volte prenotarli, e poi il biglietto arriva per una via che non controlli, con tempi che non puoi promettere al cliente. E qualcuno è in elenco perché una volta una tariffa è comparsa in una risposta di ricerca.
Un vettore che puoi mostrare ma non emettere non è copertura. Per un prodotto retail è peggio dell'assenza, perché il cliente lo sceglie, paga, e poi aspetta.
Gli hotel hanno la stessa forma con parole diverse. Il numero di strutture include quelle che il fornitore ha mappato e quelle che non ha mappato; tariffe statiche memorizzate la settimana scorsa accanto a disponibilità live; camere in allotment con un periodo di release accanto a inventario in free sale. Chiedi il numero di strutture prenotabili live nelle città in cui vendi, e chiedi come vengono unificati i duplicati tra i loro stessi fornitori: lo stesso hotel che compare tre volte a tre prezzi è un ticket di assistenza in attesa di nascere.
La prova pratica è stretta. Scrivi le venti tratte e le venti città alberghiere che fanno la maggior parte del tuo volume — per esempio Milano–Dubai, Roma–Il Cairo, hotel a Dubai e a Istanbul — e chiedi al fornitore di mostrartele funzionanti da capo a fondo in sandbox: ricerca, prezzo, prenotazione, emissione o conferma, cancellazione. Un fornitore che ha la profondità lo farà senza storie. Uno che ha solo la slide comincerà a parlare della slide.
Cosa provare in un trial: i percorsi di errore, non quelli felici
Ogni sandbox prenota con successo un biglietto di sola andata in economy su una tratta tranquilla. È ciò per cui la sandbox è stata costruita. Il tuo traffico di produzione passerà una parte significativa della sua vita sugli altri percorsi, e il trial è l'unico momento economico per vederli.
Usa il trial per eseguire questo elenco, e annota ciò che l'API ha restituito accanto a ciò che era vero dopo:
- Cambio di prezzo tra ricerca e prenotazione. La chiamata di prenotazione fallisce, va a buon fine al nuovo prezzo, o restituisce una risposta distinta che chiede conferma? La tua interfaccia sa distinguere i casi senza analizzare una stringa di messaggio?
- Offerta scaduta. Cerca, aspetta oltre la durata dell'offerta dichiarata dal fornitore, poi prenota. La scadenza è un errore specifico o lo stesso errore di «fornitore non disponibile»?
- Esaurito al momento della prenotazione. Inventario che sparisce tra prezzo e prenotazione. In che stato è la prenotazione, e l'eventuale autorizzazione di pagamento viene rilasciata?
- Nuovo tentativo dopo un timeout. Invia una richiesta di prenotazione, chiudi la connessione prima della risposta, poi rinviala. Adesso hai un PNR o due? Questa sola prova ti dice di un fornitore più di tutto il resto del trial messo insieme.
- Prenotazione creata, emissione fallita. L'API sa segnalare un PNR che esiste ma non è emesso, e ti dice la scadenza di emissione?
- Errore parziale. Una richiesta alberghiera con più camere in cui una si conferma e l'altra no. Un andata e ritorno in cui le due tratte arrivano da fonti diverse.
- Cancellazione fuori dalla finestra gratuita. La penale viene comunicata prima della conferma o la scopri in fattura?
- Fornitore fuori servizio. Chiedi al fornitore come simularne uno. Se non sa dirtelo, chiedi come i suoi clienti hanno scoperto come si comporta.
Per ogni caso stai valutando due cose. Primo: l'API ti dice la verità sullo stato della prenotazione? Secondo: il tuo codice può agire su quella verità senza che una persona legga testo libero? Un'API che fallisce in modo chiaro è più facile da gestire di una che riesce in modo ambiguo.
Abbiamo scritto più nel dettaglio del lato voli in ciò che la documentazione delle API di prenotazione voli non dice, e della progettazione di un client per fornitori alberghieri lenti in l'articolo sulla disponibilità alberghiera. Sono entrambi utili accanto a un piano di trial.
Domande che rivelano un aggregatore sottile
Non c'è niente di male in un aggregatore. La maggior parte dei contenuti di viaggio arriva alla maggior parte dei venditori attraverso uno di loro. Il rischio è quello sottile: uno strato che rivende l'API di un altro strato, aggiunge un margine e non possiede né il contratto con il fornitore né il desk operativo. Quando qualcosa si rompe, la risposta deve risalire due aziende a monte e tornare indietro.
Cinque domande lo fanno emergere in fretta:
- Chi è il fornitore contrattuale di questa prenotazione? Su quale contratto con la compagnia o l'hotel si basa?
- Con quale codice IATA e quale BSP passa il biglietto? Se la risposta è «di un partner», chiedi chi riceve l'ADM quando una regola tariffaria viene violata.
- Quando chiamo cancel, cosa succede dalla vostra parte? Una chiamata automatica al fornitore o una coda che una persona prende in carico?
- Posso vedere l'errore a monte? Uno strato sottile tende ad appiattire ogni errore in un unico codice, perché non capisce fino in fondo gli errori che riceve.
- Chi chiamo per una prenotazione live bloccata, e chi chiamano loro? Conta i passaggi.
Nessuna di queste risposte è squalificante da sola. Un codice IATA di un partner può andare bene se il contratto dice chiaramente chi si fa carico della nota di addebito. Conta che il fornitore risponda con precisione e rapidità. Le risposte vaghe di oggi sono quelle che riceverai più avanti, in produzione, in un'ora peggiore.
Quanto ti costa sbagliare
L'integrazione è la parte economica. Quelle costose arrivano dopo e non compaiono in nessuna stima.
Un bug di doppia prenotazione significa un cliente addebitato due volte e un PNR da trovare e cancellare a mano, magari dopo che la finestra gratuita di void si è chiusa. Una prenotazione riuscita a monte mentre la tua parte ha registrato un errore significa un posto trattenuto, poi cancellato automaticamente, e un cliente convinto di essere prenotato. Un vettore mostrato ma non emettibile significa un rimborso, delle scuse e un cliente che non torna. Un ADM per una regola tariffaria violata dalla via del fornitore finisce su chi è titolare del biglietto: assicurati di sapere in anticipo se sei tu.
Poi c'è il costo del cambio. Ogni stranezza del fornitore che assorbi — un codice di stato che significa due cose, un campo che a volte è una stringa — finisce nel tuo modello dati. Dopo due anni, la scelta dell'API non è più un'integrazione che sostituisci in uno sprint: è la forma della tua tabella delle prenotazioni. È questo il vero motivo per confrontare con cura adesso.
Come si colloca la nostra API in questo schema
Esponiamo API per voli e hotel. L'accesso comincia con una conversazione e non con una chiave self-service, cosa che alcuni sviluppatori trovano lenta; il motivo è che in quella conversazione le domande qui sopra vengono poste in entrambe le direzioni: quali tratte e città ti servono, quali contenuti potrai davvero emettere o confermare, e chi gestisce cosa dopo la prenotazione. Se stai facendo un confronto, porta questo elenco. La pagina delle API di viaggio è dove comincia quella conversazione.
Qualunque cosa tu scelga, sceglila dal registro del trial e non dalla presentazione. La presentazione ti dice cosa un fornitore vuole essere. I percorsi di errore ti dicono cosa è.