Technical changes in the web service SDMX

Since October 4, 2017, you can access for some series, the different versions published since June 19, 2017. This new functionnality keeps accessible all the values ​​taken by these series (without overwriting the old values ​​when adding new points).

You will find on this page the details of the main technical modifications since June 19, 2017. You can also download the correspondence table between former and new dataflows and another one for the datastructures.

Services
Dernière mise à jour le : 04/10/2017
Imprimer

The webservice now responds to https://bdm.insee.fr/series/sdmx/.

Correspondences between old and new dataflows
(xls, 46 Ko)

I – Changes in the structure of the request

In order to better comply with the standard SDMX, two changes will be made to the structure of the request.

Simplified access to series by their idbank or by dataflow

The agency must be entered as FR1. For example, FR1,IRL must be used instead of IRL.

Access to series by dataflow

All dimensions of a dataflow must be shown and separated by “.”.

The contour of the dataflows will change. There will be no automatic redirection in order to avoid the risk of misuse of data. Access to the list of dataflows

Access to the history of publications

The several published versions are available using the includeHistory parameter.

A selection of the latest published versions can be done using the updatedAfter parameter.

II – Changes in the structure of the response

Irrespective of the series, it will always have at least the following dimensions:

( )
Dimension identifier Description Change
FREQ frequency before dimension or attribute
REF_AREA geographic area before attribute
UNIT_MEASURE unit before attribute
NATURE type of measurement: index, variation, year-on-year could exist as a dimension
INDICATEUR measurement could exist as a dimension
CORRECTION raw, seasonal adjustment, seasonal adjustment-working days, etc. could exist as a dimension
TIME_PERIOD date of observation
  • The title of the series in English has been added to the title in French.
  • The Time dimension, for which the identifier is TIME_PERIOD, will be systematically defined in first position in the new responses DSD, whereas it is in last position in the current web service.
  • The unused attribute TIME_PER_COLLECT has been deleted.

III – Changes in observations

  • The following attributes have been retained and their content remains the same: OBS_STATUS and DATE_JO.
  • Four attributes have been added in order to define the observations in more detail, the main modalities are already present in the attribute OBS_STATUS.
    • OBS_QUAL: quality
      • E: estimate
      • P: provisional value
      • SD: semi-final value
      • DEF: final value
      • F: forecast
    • OBS_CONF: confidentiality
      • F: public value
      • C: confidential value
      • Q: covered by statistical confidentiality
    • OBS_TYPE: type of value
      • A: normal
      • U: atypical
      • O: missing
      • ND: not available
      • N: not significant
    • OBS_REV: revision
      • 1: revised

IV – Change in the response

There is no longer an English version of the error messages but the error codes remain the same.