Pendant la migration, il faut prendre en considération les remarques suivantes :
Il y a des méthodes et des paramètres qui sont décommissionnés.
Il y a des différences dans le format JSON.
Méthodes, paramètres et éléments qui seront décommissionnés dans API Statistics
Dans le tableau ci-dessous sont listés les méthodes, paramètres et éléments qui seront décommissionnés dans API Statistics :
cible | Méthode | |
filterNonGeo | Méthode | |
getRegionalCategorization | Méthode | Le paramètre "geo_categorical" est utilisé pour les requêtes UNICODE (les requêtes UNICODE ne seront plus supportées). |
getCountryLabel | Méthode | Le paramètre “country_label" est utilisé pour les requêtes UNICODE qui ne seront plus supportées. |
callBack | Méthode | callBack est remplacé par CORS. |
precision | Paramètre | Le paramètre “precision" est utilisé pour les requêtes UNICODE qui UNICODE ne seront plus supportées. |
shortLabel | Paramètre | |
groupedIndicators | Paramètre | |
unitLabel | Paramètre | |
HREF | Elément de la réponse JSON-stat | Non utilisé. |
Les méthodes et les paramètres qui seront continués dans API Statistics sont :
lastTimePeriod
sinceTimePeriod
untilTimePeriod
geoLevel, peut être multiple et les valeurs disponibles sont:
- aggregate: agrégats européens basés sur une liste blanche - UE15, UE25, UE27_2007, UE27_2019, UE28, EA19, etc.
country: n'importe quel code de pays (États membres de l'UE, ou AELE, ou pays candidats ou autres pays) - 2 caractères - i.e. FR
nuts1: NUTS de niveau 1 - 3 caractères - i.e. FR4 (voir cette page pour plus d’informations sur la classification NUTS)
nuts2: NUTS de niveau 2 - 4 caractères - i.e. FR41 (voir cette page pour plus d’informations sur la classification NUTS)
nuts3: NUTS de niveau 4 - 5 caractères - i.e. FR413 (voir cette page pour plus d’informations sur la classification NUTS)
- city: code au niveau de la ville - 7 caractères - i.e. DE_DEL1 (Karlsruhe)
Différences entre les réponses du service web JSON et d'API Statistics
Différences dans les valeurs TIME_PERIOD
Type de différence | service web JSON | API Statistics | |||
Changement dans le code du Time period | Pattern | Exemple | Pattern | Exemple | Commentaire |
5 ans | YYYY | 2019 | YYYY | 2019 | L’année indiquée est la dernière de la période de 5 ans. |
Année | YYYY | 2019 | YYYY | 2019 | |
Semestre | YYYYSN | 2015S1 | YYYY-SN | 2015-S1 | |
Trimestre | YYYYQN | 2015Q4 | YYYY-QN | 2015-Q4 | |
Mois | YYYYMNN | 2015M02 | YYYY-MM | 2015-02 | |
Semaine | YYYYWNN | 2020W28 | YYYY-WNN | 2020-W28 | |
Jour | YYYYMNNDNN | 2019M06D13 | YYYY-MM-DD | 2015-12-31 |
Différences entre les champs
L’ordre des champs :
service web JSON | API Statistics |
1.version 2.label 3.href 4.source 5.updated 6.status 7.extension 8.class 9.value 10.dimension 11.id 12.size | 1.version 2.class 3.label 4.source 5.updated 6.value 7.status 8.id 9.size 10.dimension 11.extension <<"href" n’est pas présent dans cette version>> |
Valeur de la propriété “source” :
service web JSON | API Statistics |
Eurostat | ESTAT |
Format de la propriété “updated” :
service web JSON | API Statistics |
YYYY-MM-DD | yyyy-MM-ddTHH:mm:ssZ |
Champ “extension” :
service web JSON | API Statistics |
La propriété identifiant le dataset est nommée "datasetId" et est en minuscule. | La propriété identifiant le dataset est nommée “id” et est en majuscule. |
La propriété “description” est présente. | La propriété “description” n’est pas présente. |
La propriété “ subTitle ” est présente. | La propriété “ subTitle ” est déplacée dans la section “annotation” – voir ci-dessous. |
“annotation” n’est pas présente | “annotation” est présente et contient les champs supplémentaires : DISSEMINATION_OBJECT_TYPE OBS_COUNT OBS_PERIOD_OVERALL_OLDEST OBS_PERIOD_OVERALL_LATEST UPDATE_STRUCTURE UPDATE_DATA SUBTITLE SOURCE_INSTITUTIONS DISSEMINATION_PRESENTATIONS |
La combinaison de drapeaux n’est pas présente. | La combinaison de drapeaux est présente. |
Champ “dimension” :
service web JSON | API Statistics |
La dimension "freq" n’est pas présente | La dimension "freq" est présente |
La propriété "label" contient le code de la dimension | La propriété "label" contient le titre de la dimension |
Champ “id” :
service web JSON | API Statistics |
"freq" n’est pas présente | "freq" est présente |
Champ “size" :
service web JSON | API Statistics |
Le champ "size" n’inclut pas la dimension "freq". | Le champ "size" inclut la dimension "freq". |