Ricerca multimodale
Interroga in un'unica richiesta tutti gli operatori treno e bus che servono un tragitto: tariffe, durate, scali, classi, carte sconto e CO₂ restituiti in tempo reale.
API partner
L'API treno e bus europea per i tuoi partner
Un'unica API REST per cercare, prenotare, cancellare e accedere alle prevendite di tutte le compagnie di treno e bus che distribuiamo. Sandbox gratuita, documentazione OpenAPI, supporto partner dedicato.
Funzionalità
L'intero percorso biglietto, esposto via API
L'API partner Gopaxo copre le quattro fasi critiche del ciclo di vita di un biglietto treno o bus, per evitarti di integrare ogni compagnia separatamente.
Prenotazione ed emissione
Prenota ed emetti i biglietti direttamente dall'API: viaggiatori nominativi, posti a sedere, opzioni bagagli, carte sconto, pagamento sicuro tramite il tuo PSP o il nostro.
Cancellazione e rimborso
Cancella un biglietto in poche chiamate, attiva il rimborso secondo le condizioni dell'operatore. Stati dettagliati, motivi di errore normalizzati, log di eventi tracciabile.
Prevendite anticipate
Accedi alle aperture vendite e alle prevendite degli operatori (TGV, Eurostar, Trenitalia, FlixBus…) non appena disponibili. Webhook per notificare i tuoi utenti in tempo reale.
Copertura vettori
Tutte le compagnie di treno e bus che distribuiamo
L'API Gopaxo espone l'intero inventario che operiamo lato pubblico: grandi operatori ferroviari, low-cost e autolinee a lunga percorrenza, in 160 paesi.
Compagnie ferroviarie
Tutti i principali operatori ferroviari e la maggior parte degli operatori regionali europei sono accessibili da un unico endpoint.
- SNCF
- OUIGO
- Eurostar
- Thalys
- Trenitalia
- Italo
- Renfe
- Deutsche Bahn
- ÖBB
- SBB
- NS
- SNCB
- CFL
- PKP
- ČD
- MÁV
- CP
- DSB
- VR
- + regionali
Compagnie di bus e autobus
Le principali autolinee a lunga percorrenza europee sono disponibili tramite la stessa API dei treni.
- FlixBus
- BlaBlaCar Bus
- Alsa
- Megabus
- National Express
- Eurolines
- RegioJet
- Student Agency
- Marino Bus
- Itabus
- Westbahn
- Vy Buss
- Onnibus
- + regionali
Caratteristiche tecniche
Pensata per i team di prodotto e piattaforma
Un'API REST moderna, documentata e osservabile, pronta per essere esaminata dal tuo team di sicurezza e architettura.
REST + JSON, OpenAPI 3
Endpoint REST documentati in OpenAPI 3, schemi tipizzati, esempi di payload per ogni flusso. Compatibile con tutti i generatori di SDK sul mercato.
OAuth 2 e chiavi API
Autenticazione OAuth 2 client credentials o chiavi API a rotazione in base al tuo stack. Scope granulare per flusso (search, book, cancel) e per ambiente.
Webhook a eventi
Notifiche firmate (HMAC) sugli eventi chiave: conferma prenotazione, cambio orario, cancellazione operatore, rimborso emesso. Retry automatici.
Sandbox gratuita
Ambiente di test iso-funzionale alla produzione, con dati di test stabili. Nessun limite di chiamate, nessun impegno, accesso condiviso con tutto il tuo team.
SLA 99,9 % e osservabilità
Disponibilità contrattuale 99,9 %, statuspage condivisa, p50 < 800 ms sulla ricerca. Log e tracce inoltrabili al tuo stack (Datadog, Grafana, Sentry…).
Documentazione e SDK
Portale sviluppatori completo, esempi curl e Postman, guide di integrazione per caso d'uso. SDK ufficiali TypeScript e Python, community open-source su GitHub.
Onboarding
Quattro passi per passare dal sandbox alla produzione
Il nostro processo di onboarding è progettato per consegnare un POC funzionante rapidamente, senza sacrificare la qualità del go-live.
1. Invii il modulo
Descrivi il tuo caso d'uso, il tuo stack, la volumetria target e il calendario ideale. Bastano 3 minuti.
2. Risposta in 24 ore lavorative
Un membro del team partner ti ricontatta per qualificare l'esigenza e pianificare uno scoping tecnico di 30 minuti.
3. Accesso alla sandbox
Token sandbox, documentazione ed esempi inviati subito dopo. Puoi iniziare a sviluppare immediatamente, senza impegno.
4. Contrattualizzazione e go-live
Una volta validato il POC, contrattualizziamo (commissione o abbonamento) e poi passiamo in produzione con un rollout progressivo e un monitoraggio congiunto.
Domande sull'API
Le domande tecniche più frequenti
Le domande affrontate con i nostri partner durante lo scoping tecnico e i test della sandbox.
L'API consente davvero la prenotazione e l'emissione dei biglietti?
Sì. L'API gestisce l'intero flusso: ricerca, selezione dell'offerta, creazione dei viaggiatori nominativi, pagamento, emissione del biglietto (PDF, codice a barre, Apple Wallet / Google Wallet a seconda dell'operatore) e invio dei giustificativi.
Come funziona la cancellazione e il rimborso?
Ogni biglietto emesso può essere cancellato tramite un endpoint dedicato. Le regole di cancellazione (tempi, importo rimborsabile, penali) sono restituite dall'API prima della conferma. Il rimborso viene attivato automaticamente in base alle condizioni dell'operatore e al metodo di pagamento iniziale.
Avete accesso alle prevendite degli operatori?
Sì. Il nostro motore integra i calendari di apertura vendite dei principali operatori (TGV, Eurostar, Trenitalia, Renfe, FlixBus). Puoi interrogare l'API in anticipo e ricevere un webhook non appena i biglietti diventano disponibili.
Quale formato? REST, GraphQL, gRPC?
REST + JSON, con una specifica OpenAPI 3 scaricabile. È il formato meglio supportato dagli strumenti di integrazione dei partner (Postman, generazione di SDK, API gateway). GraphQL non è esposto pubblicamente.
Quale autenticazione?
OAuth 2 client credentials di default per le integrazioni server-to-server, con rotazione dei segreti lato partner. Chiavi API a lunga durata restano possibili per casi specifici (CI, edge function). Tutte le richieste devono essere in TLS 1.2+.
Esiste una sandbox? È gratuita?
Sì, la sandbox è gratuita al 100 % e senza impegno. Espone gli stessi endpoint della produzione, su un set di dati di test stabile. Puoi tenerla aperta per tutto il tempo necessario per integrare, testare e proporre internamente.
Quali sono i tempi di accesso?
Entro 24 ore lavorative per la prima risposta del team partner. Il token sandbox viene generalmente rilasciato entro le 48 ore lavorative successive allo scoping tecnico.
Come venite fatturati in produzione?
Tre modelli disponibili: commissione sulle vendite (il più comune), abbonamento piattaforma + commissione ridotta, oppure licenza dedicata per volumi molto elevati. Nessuna fatturazione finché resti in sandbox.
Siete conformi a GDPR e PCI-DSS?
Sì. I dati personali sono ospitati nell'Unione europea e trattati sotto contratto di responsabile del trattamento GDPR. Il flusso di pagamento passa attraverso un PSP certificato PCI-DSS livello 1; Gopaxo non memorizza mai i dati della carta in chiaro.