Table of Contents |
---|
Les offres agrégées et validées par le BOIV IBOO sont consultables par les API de publication.
Celles-ci sont de type RESTful.
Info |
---|
IBOO met à disposition de ses utilisateurs la possibilité d’importer ses données par une API. La description et l’utilisation de cette API (parmi d’autres) est disponible dans de nombreux langages via notre notre documentation Postman. Postman permet l’utilisation de toutes les requêtes fournies si vous voulez créez votre propre espace (Voir le bouton “Run in Postman“ en haut à droite). |
Protocole
Les requêtes utilisent la méthode http GET, pour les consultations (collection ou ressource).
...
un code HTTP 200 (OK) : en cas de succès
un code HTTP 400 (Bad Request) : lorsque l’action ou le type sont inconnus.
un code HTTP 406 (Not Acceptable) : lorsque les données fournies ne permettent de traiter la demande
un code HTTP 500 (Internal Server Error) : en cas d’erreur du BOIV IBOO
Les chapitres suivant ne détailleront que les requêtes avec un code de réponse HTTP 200 apportant une information supplémentaire.
...
Par exemple : http://mon_domaine/lines[/single], la partie [/single] est optionnelle.
Sécurité
L’authentification est réalisée en utilisant une authentification par token. L’appelant doit utiliser un token d’API fournie par IDFm.
Ce token est à placer dans le champs “Authorization” du header avec la valeur :
Token token=publication_api_key
Tous les accès à l’API se font en HTTPS.
NeTEx
Les appels par API NeTEx pour récupérer les fichiers publiés retournent dans les headers de la réponse :
...
Si le navigateur fait une demande avec l'identifiant de contenu (etag) ou la dernière modification depuis l'horodatage correspond à la version du serveur, alors le serveur renvoie une réponse vide avec un état non modifié avec un code HTTP 304.
Obtenir l'Offre IDF
Méthode http ; GET
URL de la requête : URL BO Information Voyageur /api/v1/datas/idfm./netex-full.zip
Réponse :
HTTP 200 (OK) : la demande est acceptée et retourne l’offre au format Netex d’une profondeur fixe (4 semaines par défaut) sous la forme d’une archive zip organisée comme décrit au § A.1 Types de publications.
Obtenir l’offre d’une ligne
Méthode http : GET
URL de la requête : URL BO Information Voyageur /api/v1/datas/idfm/lines/{code ligne}.-netex-line.zip
code ligne : identifiant ilico de la ligne
Réponse :
HTTP 200 (OK) : la demande est acceptée et retourne l’offre au format Netex et sous la forme d’une archive zip organisée comme décrit au § A.1 Types de publications