La piattaforma di dati aperti del trasporto pubblico svizzero offre diverse API.
Per accedere all’API è necessaria una chiave API (token). Questo può essere ottenuto tramite il Portale sviluppatori.
Il token deve essere inviato nell’intestazione HTTP come “Autorizzazione” per ogni richiesta. L’utilizzo è soggetto a determinati limiti.
Il portale per gli sviluppatori consente:
- Creazione di chiavi API
- Eliminazione delle chiavi API
- Utilizzo della query per chiave.
L’API disponibile
OJP:
GTFS-RT:
Questa API NON è un’API di tipo Rest e pertanto non può essere facilmente descritta con strumenti come Swagger. Il documento necessario è disponibile nei link.
TRIAS (VDV 431) / OJP: Proprietà (DEPRECATO)
Questi servizi NON sono servizi REST. Tramite un unico punto di accesso
https://api.opentransportdata.swiss/trias2020
Le interrogazioni possono essere effettuate tramite “POST”.
(Attenzione: nessun “/” finale nella chiamata)
L’intestazione Authorisation deve contenere la chiave API.
Il tipo di contenuto deve essere impostato su “text/XML” o “application/XML”.
La risposta è sempre una struttura XML che dipende dal servizio. Questo deve poi essere elaborato.
Accesso ai “dati” nei record di dati statici tramite API
I “dati” di CKAN possono essere modificati anche tramite un’API. Questo non è soggetto alle restrizioni delle chiavi. Il ricettario contiene un esempio di fermate dell’autobus.