API
Toutes les réponses à vos questions sur l’accès à l’API.
Comment obtenir et utiliser une clé d'authentification ?
L’utilisation de l’API nécessite une clé d’authentification (« token »).
Pour obtenir votre clé d’authentification et utiliser l’API SNCF, vous devez préalablement vous inscrire au service grâce au formulaire d’inscription accessible à l’adresse : https://numerique.sncf.com/startup/api/token-developpeur/
Une fois que vous avez reçu votre clé d’authentification, vous pouvez utiliser l’API à l’URL suivante : http://api.sncf.com/v1
Il existe deux manières de s’authentifier :
– Authentification basique
Username : copiez puis collez votre clé d’authentification
Password : laissez le champ vide
– Insérez votre clé directement dans l’URL
Exemple : https://MonTokenIci@api.sncf.com/v1/coverage
Pour apprendre à faire ses premières requêtes, il est conseillé d’utiliser la console de Navitia : https://doc.navitia.io/#getting-started
Afin de faciliter la mise en page des données, vous pouvez installer une extension JSON.
Quelles sont les données accessibles dans l'API SNCF ?
L’API propose les horaires planifiés et temps réel des trains SNCF suivants : TGV, Intercités, TER, Lyria et Eurostar. Les horaires des trains Transilien sont disponibles en planifiés uniquement.
Les données proposées dans l’API évoluent. Les utilisateurs sont informés à chaque mise à jour.
Particularités pour l’Ile-de-France :
Les correspondances entre les gares de Paris intra-muros se basent sur des durées approximatives de trajet (à pied ou en transport en commun).
L’API SNCF ne couvre pas les horaires de métros du réseau opéré par RATP.
Quelle est la période de validité des données ?
-1/N/+23. Cela signifie qu’il est possible de récupérer les données du jour précédent et d’aller les requêter sur les 23 jours suivants . Ce modèle s’applique pour tous les trains disponibles dans l’API.
L’API propose-t-elle des données liées aux deux roues, bus ou cars ?
Non, l’API propose uniquement les données liées aux trains.
Que puis-je faire avec l'API SNCF ?
L’API propose les horaires planifiés et temps des trains SNCF. Elle est construite autour de plusieurs fonctionnalités qui permettent notamment de :
– Calculer des itinéraires en train d’une gare à une autre, ou de ville à ville
– Afficher les prochains départs et arrivées des trains dans une gare
– Afficher les grilles horaires des lignes de trains
– Rechercher automatiquement des noms de gares à partir d’une chaîne de caractères
L’API SNCF repose sur Navitia, un moteur de calcul d’itinéraire Open Source développé par Kisio Digital.
L'accès à l'API SNCF est-il payant ?
L’accès à l’API SNCF est gratuit dans la limite de 5 000 requêtes par jour. Si vous souhaitez bénéficiez d’un nombre de requêtes supérieur ou d’un support dédié, merci de nous contacter pour faire évoluer votre compte vers un plan adapté.
Puis-je changer de plan à tout moment ?
Vous pouvez à tout moment faire évoluer ou changer votre plan selon votre niveau d’utilisation et votre besoin de support.
Si vous souhaitez bénéficier d’une formule avec un nombre de requêtes sur mesure et des services spécifiques, contactez-nous
Quelle est la limite d'usage de l'API ?
Le plafond de l’API est défini par réutilisateur pour un volume de 5 000 requêtes par jour dans le cadre d’une formule gratuite.
Le nombre de requêtes est défini sur mesure dans le cadre d’une formule premium.
Que se passe t-il lorsque j'ai atteint mon quota ?
Dès lors qu’un utilisateur a atteint son quota de requête, l’accès au service est bloqué le temps restant.
Exemple : un utilisateur a consommé ses 5 000 requêtes/jour en douze heures. L’accès au service est donc bloqué les douze prochaines heures.
En cas de difficultés sur l'API, comment puis-je obtenir de l'aide ?
Si vous n’avez pas trouvé votre réponse dans la Documentation, nous vous invitons à prendre contact avec le service support
N’hésitez pas à nous donner le maximum de détails concernant votre demande
Je n’ai pas reçu / j'ai perdu ma clé d'authentification
Si vous avez perdu votre clé d’authentification, merci de nous contacter via notre formulaire de contact et de choisir « autres sujets ».
Quelles sont les conditions d'utilisation de l'API SNCF ?
L’API SNCF est soumise aux conditions d’utilisation présentées dans les CGU.
Merci de prendre connaissance des CGU avant toute utilisation de l’API.
Quel est le temps de réponse de l'API ?
Nous constatons 99,8 % des réponses en moins de 3 secondes (tests externes).