BP 7 - Proposer un accès aux données par API
Contexte
L'interopérabilité pour faciliter l'accès et la réutilisation de données
Le Web est une machine à développer des services. Basés sur une architecture dite "REST", de nombreux services peuvent, selon leur configuration, consulter et mettre à jour facilement des données ouvertes.
Afin de faciliter l'accès et la réutilisation de données, la mise en place d'interfaces de programmation applicative (API) visent à mettre à disposition des données dans un format facilement utilisable. Plutôt que de dupliquer et héberger soi-même des jeux de données, les API facilitent les récupérations et actualisations. Ainsi, chaque donnée mise à jour est automatiquement actualisée dans l'ensemble des services les mobilisant par API.
Bénéfices d'accès aux données par API :
Ne transférer que les données nécessaires au bon moment (filtre des données à la source)
Ne pas multiplier les duplications et donc réduire les besoins de stockage
Faciliter la récupération et donc la valorisation et l'usages des données ouvertes
Description de la bonne pratique
Architecture : Certains éditeurs de portails OpenData proposent de manière systématique le déploiement d'API. Cette fonctionnalité facilite de fait l'interopérabilité et la récupération de jeux de données.
Interopérabilité : Pour garantir ce critère d'interopérabilité des données et des services mais aussi harmoniser et faciliter la récupération de données, il est recommandé d'utiliser le principe d’architecture REST et le principe d’encodage JSON. D'autres formats pourraient être à encourager notamment pour les données dites chaudes, temps réels, comme le format BSON ou encore CBOR.
Critères d'achat : Dans certains cas, il peut être pertinent d'intégrer des critères de mises à disposition d'API et modalités d'accès, dans les cahiers des charges qui encadrent les prestataires (assurer le développement d'API, garantir une infrastructure propice à la mise à disposition d'API, ..)
Documentation : Pour chaque API proposée, il convient d'expliciter : - une documentation technique présentant les modalités d’interrogation, rythme d'actualisation, formats ou encore modalités de récupération de la donnée. Des standards tel que OpenAPI peuvent aider. - les conditions générales d’utilisation qui précise si besoin, le processus de demande d’accès, la durée ou encore si nécessaire les critères d’éligibilité des réutilisations.
API existantes : Le service api.gouv.fr propose de nombreuses données ouvertes et la documentation nécessaire pour aller les récupérer et les intégrer aux services et portails OpenData. Voici quelques exemples de bases de données accessibles par API spécifiques :
Géorisques naturels et technologiques des territoires
Piézométrie (niveau des nappes d'eau souterraine)
l'ensemble des adresses du territoire français
L'accès par API ne peut être exclusif : La CADA a récemment statué que « la consultation sur Internet de documents librement communicables ne saurait être subordonnée à une procédure de demande d’accès impliquant une autorisation préalable de l’administration ». Autrement dit, bien qu'un accès par API peut-être pratique et facilitant, il ne doit être exclusif et opérer un accès restreint à des données publiques.
Retour d'expérience
Contrôler les flux d'API - ADEME Pour protéger l'infrastructure de publication de données de l'Ademe, les appels sont limités par quelques règles simples : Un utilisateur anonyme ne peut pas effectuer plus de 100 requêtes par intervalle de 5 secondes. Sa vitesse de téléchargement totale est limitée à 2 MB/s pour les contenus statiques (fichiers de données, pièces jointes, etc.) et à 500 kB/s pour les autres appels.
Pour aller plus loin
Des standards tel que OpenAPI peuvent aider et s’intégrer très rapidement sur api.gouv.fr
Si vous souhaitez mettre à disposition et référencer votre API, vous pouvez l'enregistrer sur ce portail : https://api.gouv.fr/nouvelle-api
Dernière mise à jour