Évolutions techniques du service web SDMX

L'Insee fait évoluer la diffusion des indices et séries chronologiques. La mise en oeuvre de cette évolution est prévue pour la deuxième quinzaine de juin 2017 ; l'ensemble de la documentation sera également mise à jour. Afin de vous permettre de préparer ces évolutions, vous trouverez dans cette page le détail des principaux changements techniques à venir.

Services
Dernière mise à jour le : 12/05/2017

I – Évolutions dans la structure de l'appel

Afin de mieux respecter la norme SDMX, deux évolutions dans la structure de l'appel seront mises en place.

Accès simplifié aux séries par leur idbank ou par dataflow

  • L'agence doit obligatoirement être renseignée par FR1. Par exemple, on devra avoir FR1,IPI-2010-A21 au lieu de IPI-2010-A21.

Accès aux séries par dataflow

  • Toutes les dimensions d'un dataflow doivent être représentées et séparées par des « . ». Par exemple, on devra avoir IPPP/M..01+02.INDICE..FM… au lieu de IPPP/M..01+02.INDICE..FM.

Le contour des dataflows va changer. Aucune redirection automatique ne sera faite, afin d'éviter le risque d'utilisation erronée des données. La liste des dataflows sera mise à disposition prochainement.

Dans la phase de montée en charge du nouveau dispositif, le nombre de séries récupérables en une requête va baisser de 2 000 à 500.

II – Évolutions dans la structure de la réponse

Quelle que soit la série, celle-ci aura toujours au minimum les dimensions suivantes :

Identifiant des dimensions Description Évolution
FREQ périodicité avant dimension ou attribut
REF_AREA zone géographique avant attribut
UNIT_MEASURE unité avant attribut
NATURE type de mesure : indice, variation, glissement pouvait exister en dimension
INDICATEUR la mesure pouvait exister en dimension
CORRECTION brut, cvs, cvs-cjo... pouvait exister en dimension
TIME_PERIOD date de l'observation
  • Le libellé en anglais des séries a été ajouté en plus du libellé en français.
  • La dimension temporelle (Time Dimension) qui a pour identifiant TIME_PERIOD sera systématiquement définie en première position dans les nouvelles DSD, alors qu’elle est en dernière position dans le web service actuel.
  • L'attribut inutilisé TIME_PER_COLLECT est supprimé.

III – Évolutions dans les observations

  • Les attributs suivants sont conservés avec un contenu identique : OBS_STATUS, EMBARGO_TIME et DATE_JO.
  • Quatre attributs sont ajoutés, ils permettent de mieux détailler la qualification des observations, les principales modalités sont déjà présentes dans l'attribut OBS_STATUT.
    • OBS_QUAL : qualité
      • E : estimation
      • P : valeur provisoire
      • SD : valeur semi-définitive
      • DEF : valeur définitive
      • F : prévision
    • OBS_CONF : confidentialité
      • F : valeur publique
      • C : valeur confidentielle
      • Q : couverte par le secret statistique
    • OBS_TYPE : type de valeur
      • A : normale
      • U : atypique
      • O : manquante
      • ND : non disponible
      • N : non significative
    • OBS_REV : révision
      • 1 : révisée

IV – Évolution dans la réponse

Il n'y a plus de version anglaise des messages d'erreur mais les codes erreurs restent les mêmes.

V – Exemple de requêtes

Service web actuel Futur service web
http://www.bdm.insee.fr/series/sdmx/data/SERIES_BDM/001565183+001690224+000067677?startPeriod=2010 /series/sdmx/data/SERIES_BDM/001565183+001690224+000067677?startPeriod=2010
http://www.bdm.insee.fr/series/sdmx/data/IPC-2015-COICOP/M.01+02+03.FM.INDICE /series/sdmx/data/IPC-2015/M..01+02+03.INDICE..FM...
http://www.bdm.insee.fr/series/sdmx/dataflow/ /series/sdmx/dataflow/
http://www.bdm.insee.fr/series/sdmx/datastructure/FR1/IPC-2015-COICOP /series/sdmx/datastructure/FR1/IPC-2015
http://www.bdm.insee.fr/series/sdmx/conceptscheme/ /series/sdmx/conceptscheme/
http://www.bdm.insee.fr/series/sdmx/codelist/FR1/CL_NATURE /series/sdmx/codelist/FR1/CL_NATURE
http://www.bdm.insee.fr/series/sdmx/datastructure/FR1/id-inexistant/ /series/sdmx/datastructure/FR1/id-inexistant/

Pour toute information complémentaire concernant le service web SDMX, vous pouvez nous contacter via ce formulaire de contact.