Elenco integrazioni
Integrazione API Amadeus: il connettore voli, configurato passo dopo passo
Il modulo Amadeus collega la ricerca voli di PHPTRAVELS ad Amadeus Enterprise. Registra un'app, incolla tre credenziali nell'admin, prova in modalità sviluppo e passa in produzione quando Amadeus approva il tuo account.
- Connettore del piano Enterprise
- OAuth2 client credentials
- Sviluppo e produzione
- Guida di configurazione pubblicata
Configurazione del connettore
Dall'app Amadeus ai risultati voli in tempo reale in cinque passi
Il connettore è un modulo pronto, quindi una configurazione standard non richiede codice. Porti il tuo account Amadeus e le tue condizioni commerciali, e il modulo gestisce autenticazione, ricerca voli e creazione degli ordini dentro il modulo voli di PHPTRAVELS.
- Parti dal piano Enterprise, che include il modulo Amadeus
- Registrati su Amadeus for Developers e crea un'app con Flight Offers Search e Flight Create Orders
- Inserisci grant type, client ID e client secret in Moduli nell'admin, con Dev mode attivo
- Cerca voli sul sito e verifica il logo Amadeus sotto il pulsante Prenota ora
- Richiedi le chiavi di produzione, sostituisci quelle sandbox e porta Dev mode in produzione
- Dev mode
- Sviluppo
- Endpoint
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
Cosa fa il connettore
Offerte Amadeus nella ricerca, ordini nell'admin
Due API Amadeus fanno funzionare il modulo: una restituisce le offerte voli alla pagina dei risultati, l'altra crea la prenotazione quando il viaggiatore paga.
- APILondra - New York · DirettoEconomy · 8 h 05 min · 1 bagaglio in stiva486 USDper adulto
- v2Londra - New York · 1 scaloEconomy · 11 h 20 min via Dublino · 1 bagaglio in stiva412 USDper adulto
- Londra - New York · DirettoBusiness · 7 h 55 min · 2 bagagli in stiva2140 USDper adulto
Flight Offers Search e Flight Create Orders
Offers Search riempie i risultati; Create Orders trasforma l'offerta scelta in prenotazione. Attiva entrambe nella tua app Amadeus per cercare e prenotare.
Autenticazione OAuth2
Il modulo richiede i token di accesso con il grant client_credentials, usando client ID e secret inseriti nell'admin.
Modalità sviluppo e produzione
Un'unica impostazione, Dev mode, decide se le richieste usano le chiavi sandbox o le chiavi di produzione approvate.
Endpoint Enterprise
Il modulo si basa su travel.api.amadeus.com/v2/. Alcune regioni usano un endpoint diverso, quindi verifica il tuo prima di inserire le chiavi.
Fonte visibile su ogni risultato
Un logo Amadeus sotto il pulsante Prenota ora mostra quali tariffe arrivano da Amadeus, così verifichi la connessione a colpo d'occhio.
Cause di errore note
La maggior parte degli errori dipende da credenziali sbagliate, da una modalità che non corrisponde alle chiavi o da un servizio API inattivo nella dashboard Amadeus.
Flusso delle richieste
Cosa succede a ogni ricerca Amadeus
La stessa sequenza gira in sviluppo e in produzione; cambiano solo le chiavi e l'impostazione Dev mode.
Autenticare
Client ID e secret vengono scambiati con un token di accesso.
Cercare
Flight Offers Search restituisce le tariffe per tratta, date e passeggeri.
Mostrare
Le offerte compaiono con il tuo ricarico, accanto ai risultati degli altri fornitori collegati.
Ordinare
Flight Create Orders prenota l'offerta scelta con i dati del viaggiatore.
Registrare
La prenotazione viene salvata nell'admin e la conferma inviata via email.
Dove si colloca Amadeus
Il tuo account Amadeus, altre API voli e sviluppo su misura
Il modulo Amadeus è uno dei diversi connettori voli, ognuno con le proprie credenziali nella stessa ricerca.
Il tuo account Amadeus Enterprise
Amadeus rilascia le chiavi di produzione dopo aver esaminato caso d'uso, registrazione aziendale e sito web, e tu accetti le condizioni commerciali.
Altri connettori voli
Aggiungi Duffel, Kiwi o altri fornitori di voli dall'elenco integrazioni e confronta le tariffe in un'unica lista.
Altri endpoint e API
Un endpoint Amadeus regionale o un'API che il modulo non usa ancora può essere aggiunto come sviluppo su misura.
Fornitori di voli che puoi collegare:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
Back office
Gestisci le prenotazioni Amadeus dallo stesso admin
Inserite le chiavi, le tariffe Amadeus seguono le regole che usi già per ogni altro fornitore di voli.
Ricarichi sui voli
Ricarichi fissi o in percentuale perché le tariffe Amadeus mostrino il tuo prezzo di vendita.
Elenco prenotazioni
Le prenotazioni Amadeus compaiono con dati del viaggiatore e stato nella schermata prenotazioni voli.
Agenti B2B
Gli agenti cercano e prenotano tariffe Amadeus nel portale agenti con le proprie tariffe.
Pagamenti
I viaggiatori pagano con i gateway attivati, gli agenti dal proprio wallet.
Chiavi sul tuo server
Le credenziali restano nel tuo admin self-hosted, non su una piattaforma condivisa.
Ticket di assistenza
Apri un ticket su app.phptravels.com se una connessione o una prenotazione richiede il nostro aiuto.
Confronto
Sviluppare da soli su Amadeus vs il modulo PHPTRAVELS
Entrambi usano lo stesso account Amadeus. La differenza è quanto il tuo team scrive e mantiene intorno.
| Attività | Integrazione API diretta | PHPTRAVELS |
|---|---|---|
| Autenticazione | Integrazione API direttaRichiesta e rinnovo dei token scritti dai tuoi sviluppatori | PHPTRAVELSGestita dal modulo con tre campi dell'admin |
| Risultati di ricerca | Integrazione API direttaDati delle offerte da mappare sulla tua pagina risultati | PHPTRAVELSOfferte mostrate nella ricerca voli esistente |
| Prenotazione | Integrazione API direttaModuli viaggiatore e chiamate d'ordine da zero | PHPTRAVELSCreate Orders collegato a checkout e pagamento |
| Test e produzione | Integrazione API direttaConfigurazione separata per ogni ambiente | PHPTRAVELSUn solo interruttore Dev mode |
| Ricarichi e prenotazioni | Integrazione API direttaUn back office da progettare e costruire | PHPTRAVELSIncluso nell'admin voli |
| Passi di configurazione | Integrazione API direttaScritti e aggiornati dal tuo team | PHPTRAVELSGuida pubblicata su docs.phptravels.com |
Casi d'uso
Chi attiva il modulo Amadeus
Agenzie di viaggio online
Ricerca voli pubblica su contenuti Amadeus, con il tuo ricarico e il tuo checkout.
Reti di agenti B2B
I sub-agenti prenotano tariffe Amadeus dal tuo portale alle tue tariffe.
Società di gestione viaggi d'affari
I prenotatori aziendali cercano tariffe Amadeus su una piattaforma che ospiti e controlli tu.
Perché PHPTRAVELS
Un connettore che puoi leggere, modificare e ospitare
Codice sorgente incluso
Self-hosted con licenza commerciale, così gli sviluppatori possono estendere il modulo Amadeus.
Configurazione documentata
Ogni passo, campo e causa di errore è descritto su docs.phptravels.com.
24 lingue
Mostra le tariffe Amadeus nelle lingue dei tuoi mercati, comprese quelle da destra a sinistra.
B2C e B2B
Un'unica installazione per il sito pubblico e il portale agenti.
Domande frequenti
Domande sul connettore Amadeus
Cosa chiedono i team mentre configurano il modulo Amadeus.
Contatta il team venditeÈ un modulo voli pronto. Crei un'app su Amadeus for Developers, inserisci le sue credenziali nell'admin e le offerte Amadeus compaiono nella ricerca voli, con prenotazioni create tramite Flight Create Orders.
Il modulo Amadeus è disponibile con il piano Enterprise, un pagamento unico di $9999 indicato nella pagina prezzi. Il tuo account Amadeus e le relative condizioni commerciali sono separati e concordati con Amadeus.
Un grant type client_credentials, un client ID e un client secret. Amadeus rilascia le chiavi sandbox quando crei l'app e quelle di produzione dopo aver approvato la richiesta di produzione.
Il modulo usa travel.api.amadeus.com/v2/. Alcune regioni hanno endpoint o parametri diversi, quindi verifica prima il tuo account; altri endpoint si possono aggiungere come sviluppo su misura.
Entrambe le cose, in base alle API attive nella tua app Amadeus. Flight Offers Search fornisce i risultati e Flight Create Orders deve essere attiva per le prenotazioni.
Il connettore documentato riguarda i voli. Amadeus è elencato anche come fornitore di alloggi, ma la sua guida di configurazione non è ancora pubblicata, quindi chiedi al nostro team per gli hotel.
Continua a esplorare