API SDMX 2.1 - Découverte des données

Ces opérations de l’API supportent des requêtes pour les catalogues de données et des listes SDMX de métadonnées structurelles et de données.

Point de terminaison SDMX 2.1 - Listes SDMX de métadonnées structurelles et de données

Voici la requête REST permettant de retrouver la liste de toutes les métadonnées structurelles depuis le point de terminaison SDMX 2.1:

https://<api_base_uri>/sdmx/2.1/<resource>/<agencyID>/all?detail=<details>

où

Paramètre	Description
api_base_uri	Voir définition de api_base_uri
resource	Les ressources suivantes sont supportées: dataflow datastructure codelist conceptscheme
agencyID	Voir définition de agencyID
Optionnel	Description
details	Portée de la requête: full (valeur par défaut) renvoie toutes les informations relatives à chaque élément. Cette requête peut renvoyer un nombre important de réponses. Dès lors, il est préférable de soumettre une première requête afin d’obtenir une vue d’ensemble, puis d’émettre ensuite une requête individuelle pour chaque artefact (pertinent). allstubs / referencestubs renvoie uniquement le nom de chaque élément
completestubs	true renvoie le nom, la description et les annotations de chaque élément

comme illustré par

SDMX fournit un métamodèle décrivant les données de n’importe quel domaine statistique:

Un category scheme est un container reprenant des catégories, qui peuvent être organisées en arbre hiérarchique.
Les catégories (cf. SDMX) sont utilisées pour classer les flux de données:
- Chaque flux de données peut être connecté à une ou plusieurs catégories, et
- Toute catégorie peut être liée à aucun, un ou plusieurs flux de données.
Une catégorisation relie une catégorie faisant partie d’un Category Scheme à une autre structure identifiable en SDMX. Dans un environnement de dissémination, une catégorisation relierait typiquement une Catégorie à un flux de données.

La requête est identique à celle permettant de retrouver la liste de toutes les métadonnées structurelles :

https://<api_base_uri>/sdmx/2.1/<resource>/<agencyID>/all

où

Paramètre	Description
api_base_uri	Voir définition de api_base_uri
resource	Les ressources suivantes sont supportées: categoryscheme categorisation
agencyID	Voir définition de agencyID

Il n’y a pas de paramètre detail pour les ressources 'categoryscheme' et 'categorisation'.

Exemples
Récupérer tous les categoryschemes :
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/categoryscheme/ESTAT/all
Récupérer toutes les catégorisations :
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/categorisation/ESTAT/all

La requête est identique à celle permettant de retrouver les autres métadonnées structurelles :

https://<api_base_uri>/sdmx/2.1/<resource>/<agencyID>/<resourceID>

où

Paramètre	Description
api_base_uri	Voir définition de api_base_uri
resource	Les ressources suivantes sont supportées: categoryscheme categorisation
agencyID	Voir définition de agencyID
resourceID	L’identifiant de la ressource La resourceID pour une catégorisation est un GUID. Cette information peut être obtenue en récupérant la liste de toutes les catégorisations.

comme illustré par

Exemples
Renvoie le categoryscheme de AGRIC :
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/categoryscheme/ESTAT/AGRIC
Renvoie une catégorisation faisant partie de AGRIC :
https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/categorisation/ESTAT/APRO_MT_STRPIG_uuid_apro_mt_str

Expand all Collapse all