L'interface SIRI (pour Service Interface for Real time Information) â est un protocole dâĂ©change de lâinformation Temps RĂ©el pour les transports collectifs (format XML).
Point d'accĂšs
Il existe 2 moyens de se connecter au temps réel SIRI mis à disposition par Pysae:
AccĂšs public : limitĂ© Ă 1 requĂȘte par seconde
AccÚs authentifié (API-KEY) : aucune restriction
Pour générer une API KEY il faut :
Se créer un compte sur la plateforme d'API Management : https://api.okina.fr/user/registration
Se connecter
Souscrire Ă l'API : https://api.okina.fr/catalog/api/29dd69b7-09e6-4eee-9d69-b709e60eee17/subscribe
Choisir "accÚs authentifié", puis cliquer sur Suivant
Sélectionner "Default application" dans la liste déroulante et remplir le champs concernant la volumétrie d'utilisation, puis Valider
Attendre la validation manuelle de la demande
Récupérer l'API Key dans "Applications" > "Souscriptions" et en cliquant sur l'API key
Limites par type d'accĂšs
AccĂšs libre :
limité au Siri
limitĂ© au mode requĂȘte
limitĂ© Ă 1 requĂȘte par seconde
AccÚs authentifié
accĂšs au Siri et Siri Lite
accĂšs au mode requĂȘte et mode abonnement
pas de limite de fréquence
Services Siri disponibles
Les services suivants sont disponibles en mode "requĂȘte" ou "abonnement":
CheckStatus
StopPointsDiscovery
LinesDiscovery
StopMonitoring
VehicleMonitoring
EstimatedTimetable
Situation Exchange
Format des requĂȘtes Siri
Les requĂȘtes Siri peuvent ĂȘtre envoyĂ©es au format XML brut ou SOAP. Les endpoints devront ĂȘtre adaptĂ©s selon le format que l'utilisateur souhaite utiliser :
format XML brut :
format SOAP
Exemple d'interrogation du service temps réel
Voici un exemple d'interrogation du service temps réel des Cars Faure sur le SYTRAL.
L'url de base pour accéder aux services est la suivante : https://api.okina.fr/gateway/fau/realtime/
L'ensemble des services sont documentés ici : https://api.okina.fr/catalog/api/29dd69b7-09e6-4eee-9d69-b709e60eee17/doc?page=363ff9f9-1dce-4126-bff9-f91dce1126d7
Exemple de requĂȘte sur le service /anshar/services (Sans oublier de renseigner l'API-KEY gĂ©nĂ©rĂ©e prĂ©cĂ©demment) :
Exemple de réponse:
â

