Cette API constitue un accès gratuit aux données et métadonnées statistiques. Cette interface doit être utilisée pour l’automatisation des requêtes sur les donnés et métadonnées ainsi que sur les téléchargements.
Pour mieux en comprendre le contexte, il peut également être pertinent de découvrir la méthode permettant de réaliser des téléchargements manuels de données et de métadonnées via l’interface web.
Comment sont structurées les pages de cette aide en ligne relatives à l’API ?
L’aide en ligne relative à l’API est divisée en plusieurs parties:
Cette page d’introduction contient principalement les informations de base relatives aux formats sémantiques des réponses de données et de métadonnées. Cela est particulièrement utile pour obtenir des informations supplémentaires à propos de SDMX et de JSON-stat.
La page Démarrage, qui est la page suivante, fournit un bref aperçu des différents points de terminaison supportés dans l’API. Il est fortement recommandé de lire cette page avant de poursuivre la lecture des autres pages relatives à l’API.
La page Découverte des données fournit des informations relatives à la technique à employer afin d’obtenir les catalogues et les listes de données et de métadonnées.
Les pages Requête sur les métadonnées et Requête sur les données se focalisent sur les appels API de base permettant d’obtenir les informations relatives aux données et aux métadonnées.
Les pages Filtrage sur les métadonnées et Filtrage sur les données fournissent des informations relatives à des techniques plus avancées permettant d’obtenir les métadonnées et les produits de données.
La page reprenant la Foire aux questions (FAQ).
Quelles sont les organisations qui exposent cette API ?
Cette API est exposée par:
Eurostat, l’office de statistiques de l’Union européenne
Plusieurs Directions Générales de la Commission Européenne:
La Direction Générale de la Concurrence, ci-après dénommée DG COMP
La Direction Générale de l’Emploi, des Affaires Sociales et de l’Inclusion, ci-après dénommée DG EMPL
La Direction Générale du Marché Intérieur, de l’Industrie et de l’Entrepreneuriat, ci-après dénommée DG GROW
Protocole supporté
Cette API est disponible via le protocole HTTPS.
Support de SOAP et REST
Selon le type d’opération concernée, cette API supporte l’architecture Representation State Transfer (REST) et/ou Simple Object Access Protocol (SOAP).
Les points de terminaison WSDL (SOAP) et WADL (REST) sont expliqués à la page Démarrage.
Cette aide en ligne décrit les opérations REST, étant donné que l’usage de celles-ci est recommandé.
Le paramètre <api_base_uri> dans la description des opérations
Cette documentation fait référence à un paramètre <api_base_uri> dans la description de chaque requête REST. Ce paramètre est propre à chaque organisation exposant l’API.
Les valeurs autorisées pour le paramètre <api_base_uri> sont :
Agence | Valeur <api_base_uri> à employer |
|---|---|
Eurostat | https://ec.europa.eu/eurostat/api/dissemination https://ec.europa.eu/eurostat/api/comext/dissemination (ensembles de données Comext et Prodcom) |
DG COMP | https://webgate.ec.europa.eu/comp/redisstat/api/dissemination |
DG EMPL | https://webgate.ec.europa.eu/empl/redisstat/api/dissemination |
DG GROW | https://webgate.ec.europa.eu/grow/redisstat/api/dissemination |
Ensemble de données Comext dans API
Note importante : des points de terminaison de la nouvelle API sont dédiés au téléchargement des ensembles de données Comext et Prodcom.
Pour ces ensembles de données, la partie nommée <api_base_uri> est : https://ec.europa.eu/eurostat/api/comext/dissemination
Dans l’URL ci-dessus, “comext/” a été ajouté afin de différencier cette URL de base de l’URL principale : https://ec.europa.eu/eurostat/api/dissemination
Note complémentaire concernant les ensemble de données Comext : ceux-ci ne peuvent pas être téléchargés dans leur entièreté en raison de leur taille. Ils doivent impérativement être filtrés.
Le paramètre <agencyID> dans la description des opérations SDMX
Cette documentation fait référence à un paramètre <agencyID> dans la description de chaque requête SDMX REST ainsi que dans d’autres requêtes de découverte de données. L’agence est l’organisation (ou autre corps expert) responsable de la maintenance opérationnelle des artéfacts de données couramment utilisés.
Les valeurs autorisées pour le paramètre <agencyID> sont :
Agence | Valeur <agency_id> à employer |
|---|---|
Eurostat | ESTAT |
DG COMP | COMP |
DG EMPL | EMPL |
DG GROW | GROW |
Formats sémantiques supportés
Cette API fournit des réponses dans les formats suivants :
Le format SDMX-ML (Statistical Data and Metadata Exchange) (SDMX) renvoie les messages comme document XML
Le format SDMX-CSV (Statistical Data and Metadata Exchange) (SDMX) renvoie les messages comme fichier CSV
Le format JSON-stat, qui est un format JSON simple et léger dédié à la dissémination des données
Le formats de fichiers TSV (Valeurs séparées par une tabulation) dont chaque ligne est constituée d’une séquence de valeurs, séparées par une tabulation (TSV)
Echange de données et métadonnées statistiques (SDMX)
L’initiative Statistical Data and Metadata Exchange (SDMX) est sponsorisée par une large gamme d’institutions publiques, y compris Eurostat.
Cette norme décrit et universalise une façon d’échanger des données statistiques, et fournit des formats standards pour les données et les métadonnées, des directives relatives au contenu, mais également une architecture IT permettant l’échange de données et de méta-données.
La grande majorité des opérations de cette API implémente les directives SDMX en matière de services web.
Les termes utilisés dans la norme SDMX sont les suivants :
Ensemble de données : une collection d’observations liées, organisées selon une structure prédéfinie
Définition de structure de données (DSD) : métadonnée décrivant la structure et l’organisation d’un ensemble de données ainsi que les concepts statistiques et les listes de codes utilisée dans l’ensemble de données
Dimensions : concepts qui déterminent la structure "physique" des ensembles de données
Liste de codes : une liste de codes est une liste prédéfinie à partir de laquelle certains concepts statistiquement codés prennent leurs valeurs. Chaque liste de codes dispose des propriétés suivantes :
identifiant (cela fournit une identification unique au sein de l’ensemble des listes de codes maintenues par une agence de maintenance des définitions structurelles) ;
nom (unique également) ;
description (une description de l’objectif de la liste de codes) ; et
la longueur de la valeur du code (il s’agit d’une part d’un nombre exact ou d’un nombre maximal de caractères, et d’autre part d’un type, comme par exemple numérique ou alphanumérique)
Attributs : apporte des informations supplémentaires à propos des concepts utilisés et n’affecte pas la structure de l’ensemble de données lui-même
Flux de données : une structure qui décrit, catégorise et contraint le contenu autorisé d’un ensemble de données que les fournisseurs transmettent, et ce pour différentes périodes de référence
Concept scheme : information descriptive pour un arrangement ou une division de concepts en groupes basés sur des caractéristiques que ces objets ont en commun. Un concept scheme est une liste maintenue de concepts utilisés dans une famille de clé et dans les définitions de structures de métadonnées
(Ces définitions proviennent de l’espace d’information EUROSTAT SDMX et du Glossaire des termes statistiques de l’OCDE.
Voir également la définition formelle du modèle d’information SDMX, ainsi qu’un résumé réalisé par Metadata Technology.
JSON-stat
JSON-stat est un format JSON simple et léger de dissémination, idéal pour la visualisation des données, les applications mobiles et les initiatives de données ouvertes.
Il est basé sur un modèle cubique issu du constat selon lequel la forme la plus commune de dissémination des données est la forme tabulaire.
Dans ce modèle cubique, les ensembles de données sont organisés en dimensions. Les dimensions sont organisées en catégories.
La particularité de ce format est qu’il combine :
Les données SDMX provenant des ensembles de données tels que les observations et les statuts
Les métadonnées SDMX provenant de la structure, du flux et des contraintes, telles que le titre des ensembles de données, le libellé des listes de codes, etc.
Formats de fichiers TSV (Valeurs séparées par des tabulations)
Lorsque le format TSV est spécifié dans les paramètres de la requête soumise par l’utilisateur, les requêtes de données et de métadonnées SDMX 2.1 peuvent renvoyer des réponses dans le format de fichier TSV (Valeurs séparées par une tabulation).
L’API fournit-elle des informations en plusieurs versions ?
L’API fournit :
Les artéfacts structurels suivants sont déclinés en plusieurs versions et la spécification finale SDMX suivante : listes de codes, schémas conceptuels, et définitions de structure de données : chaque version de chaque élément est disponible et peut être téléchargée par l’intermédiaire de l’API.
Pour un produit de données statistiques, les artéfacts SDMX correspondants sont non-finaux et toujours avec la version 1.0.
Aucun historique des données statistiques n’est disponible.