Alternativa all'API Amadeus Self-Service: migrare in una settimana

Lo scopri da un health check fallito, o da un utente. L'endpoint di ricerca che la tua app di voli chiama dal primo prototipo restituisce un errore mai visto prima, e il portale da cui gestivi le chiavi non esiste più. Se stai cercando un'alternativa all'API Amadeus Self-Service, probabilmente sei proprio lì: un prodotto che funziona, un codice costruito attorno alle richieste di un solo fornitore e poco tempo prima che gli utenti si accorgano che la ricerca è rotta.
Sul fornitore vale la pena riportare un solo fatto. Amadeus ha dismesso il portale Self-Service API il 17 luglio 2026, e i nuovi sviluppatori vengono indirizzati al canale Enterprise, che funziona su contratto. Questo articolo non dirà altro sui motivi. La domanda utile è che cosa lo sostituisce e come migrare in circa una settimana senza ricostruire ciò che funziona ancora.
Che cosa ti dava davvero il self-service
È facile ricordare il vecchio portale come «un'API voli» e mettersi a cercare un'altra API voli. Così però si perde ciò che lo rendeva utile a una startup di due persone o a un progetto del fine settimana. Tre cose, soprattutto:
- Una modalità di test raggiungibile in un pomeriggio. Registrazione, chiave, chiamata di ricerca. Nessuno ti chiedeva di cosa si occupasse la tua azienda.
- Prezzi a consumo. Pagavi quello che chiamavi; un prodotto con cento utenti costava quanto deve costare un prodotto con cento utenti.
- Nessun ciclo commerciale. Nessuno doveva approvarti prima che scrivessi codice.
Un contratto enterprise ribalta tutte e tre. L'accesso arriva dopo una conversazione commerciale, il prezzo si negozia e l'ambiente di test arriva insieme alle carte. Dal lato del venditore non c'è nulla di irragionevole: distribuire contenuto aereo comporta obblighi reali. Ma il tuo piano cambia. Se contavi di sostituire una chiave API con un'altra, la risposta onesta è che la maggior parte delle alternative serie non funziona più così, compresa quella offerta da questo sito. Ci torniamo più avanti.
Tre strade verso un'alternativa all'API Amadeus Self-Service
Togli i nomi dei marchi e restano tre tipi di sostituto. Si distinguono meno per il loro JSON che per chi firma con te e chi, alla fine, emette il biglietto.
| Strada | Tempo fino alla prima prenotazione reale | Contenuto da aspettarsi | Chi detiene la placca di emissione |
|---|---|---|---|
| Contratto diretto con un GDS | Il più lungo: verifica commerciale, certificazione, poi lo sviluppo | Ampio contenuto GDS; NDC e low cost dipendono dal contratto | Tu, se hai l'accreditamento IATA; altrimenti ti serve comunque qualcuno che lo abbia |
| API di un aggregatore | Intermedio: onboarding più leggero, ma aspettati un contratto | Un mix di GDS, NDC e LCC, a seconda delle fonti collegate dall'aggregatore | Di solito l'aggregatore stesso o un suo partner di emissione |
| API di un consolidatore | Spesso la via più breve verso un biglietto emesso, perché l'emissione è già risolta | Ciò che vende il consolidatore: le sue tariffe negoziate e nette, più ciò che portano i suoi fornitori | Il consolidatore, con il proprio accreditamento |
Puoi non essere d'accordo con la colonna centrale, e per il tuo caso dovresti verificarla. Un team già accreditato e con una figura commerciale interna potrebbe trovare la strada GDS più rapida di quanto suggerisca la tabella. Ma la maggior parte degli sviluppatori che ha costruito su una sandbox self-service non ha mai avuto una placca di emissione, ed è l'ultima colonna a decidere quanta parte del prodotto funziona ancora dopo la migrazione.
Il motivo è questo. Ricerca e quotazione sono operazioni di lettura: tutte e tre le strade te le danno. Emettere un biglietto è invece un atto finanziario, compiuto sotto l'accreditamento di qualcuno e regolato tramite BSP o equivalente, e se quel qualcuno non sei tu, ti serve un accordo con chi lo è. I team che saltano questa domanda finiscono con una bella pagina di ricerca e un pulsante «prenota» che crea una prenotazione che nessuno paga.
Il contenuto è l'altra colonna da leggere con calma. Contenuto GDS e contenuto NDC non sono le stesse tariffe, e le compagnie low cost spesso non stanno in nessuno dei due. Se i tuoi utenti volano soprattutto su tratte brevi in Italia e in Europa, dove le low cost pesano molto, anche una strada con un'ottima copertura GDS può restituire risultati scarsi. Abbiamo approfondito la differenza in NDC API o GDS: cosa cambia per chi integra.
Come funziona l'accesso qui, e perché non è una chiave nemmeno qui
Questa piattaforma espone API per voli e hotel. L'accesso comincia con una conversazione, non con una chiave self-service. Lo diciamo chiaramente perché la cosa peggiore che ti può capitare questa settimana è registrarti da qualche parte aspettandoti l'esperienza di prima e scoprire al quarto giorno che sulla strada c'è un'approvazione umana.
La conversazione riguarda soprattutto le domande della tabella: che cosa stai costruendo, chi sono i tuoi utenti, se ti serve l'emissione o solo ricerca e prezzo, e su quali mercati vendi. Queste risposte decidono quale contenuto ricevi e come si regolano le prenotazioni. Se vuoi avviarla, il punto di partenza è la pagina delle API di viaggio.
Ovunque tu vada, fai la stessa domanda nella prima e-mail: esiste una chiave di test self-service, e che cosa deve succedere prima della produzione? Una risposta chiara è un buon segnale per il resto dell'integrazione. Anche una risposta vaga ti dice qualcosa.
Una checklist di migrazione, nell'ordine in cui le cose si rompono
La maggior parte delle integrazioni self-service aveva la stessa forma: ricerca, prezzo, creazione dell'ordine, emissione, e poi tutto ciò che succede quando il biglietto esiste. Ritesta ogni passaggio con il nuovo fornitore come se non l'avessi mai scritto. I nomi delle richieste cambieranno; a mordere sono le ipotesi sepolte nel tuo codice.
- Ricerca. Mappa il tuo modello di query (origine, destinazione, date, passeggeri, cabina) sulla nuova richiesta. Controlla come si passano le età di bambini e neonati, se il multitratta è una chiamata separata e com'è fatto un risultato vuoto. Una lista vuota e un errore sono cose diverse, e la tua interfaccia probabilmente le tratta allo stesso modo.
- Identità dell'offerta. Scopri per quanto tempo resta valido un id di offerta e se sopravvive a un ricaricamento della pagina. Il codice che salvava un'offerta in sessione e la quotava dieci minuti dopo fallirà in modi nuovi.
- Prezzo. Riquotare prima di prenotare non è facoltativo con la maggior parte dei fornitori. Gestisci il caso in cui il prezzo è cambiato e decidi che cosa vede l'utente quando succede.
- Ordine. Nomi dei passeggeri, campi dei documenti, contatti. Valida i formati dal tuo lato prima di inviarli; un ordine rifiutato dopo che il cliente ha pagato è il bug più costoso di questa lista.
- Biglietto. Verifica se la chiamata d'ordine emette anche il biglietto o se l'emissione è un passaggio separato con un proprio time limit. Sappi su quale placca esce il biglietto prima di incassare i soldi di chiunque.
- Post-emissione. Cancellazione, void, rimborso, cambio operativo. Sono le chiamate di cui un prototipo non ha mai avuto bisogno e di cui un prodotto in produzione ha bisogno nel primo mese. Chiedi se esistono nell'API o passano da un servizio di assistenza.
Per un piano di test più completo, compreso ciò che si può simulare e ciò che non va mai simulato, vedi il nostro piano di test per API di viaggio in sandbox. Se arrivi dal lato dell'integrazione, l'integrazione di un'API di prenotazione voli ripercorre l'intero flusso.
Quanto costa una migrazione affrettata
La tentazione è avvolgere il nuovo fornitore dietro la tua vecchia interfaccia client e pubblicare appena la ricerca restituisce risultati. La ricerca sembrerà a posto. Si rompe tutto ciò che la demo non ha mostrato.
Un prezzo cambiato tra ricerca e ordine, mostrato all'utente come errore grezzo, ti fa perdere la prenotazione. Un ordine creato senza emissione, perché il nuovo fornitore separa i due passaggi e il tuo codice no, lascia un passeggero convinto di avere un biglietto che non ha. Un flusso di rimborso che in silenzio non fa nulla finché qualcuno non scrive all'assistenza diventa un chargeback. Ognuno di questi incidenti si supera una volta. Ripetuti su tutta la base utenti, ti costano la fiducia di cui vive un piccolo prodotto di viaggio.
C'è anche un costo più silenzioso. Se scegli una strada perché questa settimana era la più rapida e poi scopri che non porta il contenuto che i tuoi utenti cercano, migrerai due volte. Una giornata dedicata alle domande su contenuto ed emissione prima di scrivere codice è l'assicurazione più economica di tutto il lavoro.
Una settimana, più o meno
Il primo giorno va alle domande: quale strada, quale contenuto, quale placca. Il secondo e il terzo a ricerca e prezzo con il nuovo fornitore. Il quarto a ordine ed emissione dall'inizio alla fine, casi di errore compresi. Il quinto alla post-emissione e alla lettura dei tuoi log. Se la conversazione con un fornitore dura più di un giorno, comincia a programmare sulla sua documentazione in parallelo; la forma delle richieste cambia di rado, una volta vista.
Non somiglierà al pomeriggio che ti era servito per ottenere la tua prima chiave self-service. Non serve. Quello che costruisci adesso deve emettere biglietti dietro i quali qualcuno risponde.