t1. L'interfaccia SIRI (per Service Interface for Real time Information) – è un protocollo di scambio di informazioni in tempo reale per i trasporti pubblici (formato XML).
t2. Punto di accesso
t3. Esistono 2 modi per connettersi al tempo reale SIRI messo a disposizione da Pysae:
t4. Accesso pubblico: limitato a 1 richiesta al secondo
t5. Accesso autenticato (API-KEY): nessuna restrizione
t6. Per generare una API KEY occorre:
t7. Creare un account sulla piattaforma di gestione delle API: t8. https://api.okina.fr/user/registration
t9. Connettersi
t10. Iscrizione all'API: t11. https://api.okina.fr/catalog/api/29dd69b7-09e6-4eee-9d69-b709e60eee17/subscribe
t12. Scegliere "accesso autenticato", quindi fare clic su Avanti
t13. Selezionare "Default application" nella lista a discesa e compilare il campo relativo alla volumetria di utilizzo, quindi Validare
t14. Attendere la validazione manuale della richiesta
t15. Recuperare la API Key in "t16. Applicazionit17. " > "t18. Sottoscrizionit19. " e facendo clic sulla chiave API
t20. Limiti per tipo di accesso
Accesso libero:
limitato a Siri
limitato alla modalità richiesta
limitato a 1 richiesta al secondo
Accesso autenticato
accesso a Siri e Siri Lite
accesso alla modalità richiesta e modalità abbonamento
nessun limite di frequenza
Servizi Siri disponibili
I seguenti servizi sono disponibili in modalità "richiesta" o "abbonamento":
CheckStatus
StopPointsDiscovery
LinesDiscovery
StopMonitoring
VehicleMonitoring
EstimatedTimetable
Situation Exchange
Formato delle richieste Siri
Le richieste Siri possono essere inviate in formato XML grezzo o SOAP. Gli endpoint dovranno essere adattati in base al formato che l'utente desidera utilizzare:
formato XML grezzo:
format SOAP
Esempio di interrogazione del servizio tempo reale
Ecco un esempio di interrogazione del servizio tempo reale dei Cars Faure sul SYTRAL.
L'URL di base per accedere ai servizi è il seguente: https://api.okina.fr/gateway/fau/realtime/
L'insieme dei servizi sono documentati qui: https://api.okina.fr/catalog/api/29dd69b7-09e6-4eee-9d69-b709e60eee17/doc?page=363ff9f9-1dce-4126-bff9-f91dce1126d7
Esempio di richiesta sul servizio /anshar/services (Senza dimenticare di inserire l'API-KEY generata precedentemente):
Esempio di risposta:

