Restrictions applicables aux paramètres de requête des API
Afin de garantir la stabilité et les performances des services et des API de l'Explorateur des données de l'OCDE, des restrictions ont été introduites concernant l’utilisation de certains paramètres de requête pour un nombre limité de jeux de données de très grande taille.
Nous avons constaté que certains types de requêtes API peuvent générer des charges très importantes lorsqu’ils sont appliqués à des jeux de données contenant un grand volume d’observations. Dans certaines situations, cela peut avoir un impact sur les performances globales du système et affecter la disponibilité du service pour les autres utilisateurs.
Pour atténuer ce risque, des mécanismes de protection au niveau serveur ont été mis en place afin de restreindre l’utilisation de paramètres spécifiques pour certains flux de données. La section ci‑dessous décrit les paramètres actuellement concernés ainsi que les jeux de données affectés.
lastNObservations et firstNObservations
Les requêtes API utilisant les paramètres lastNObservations ou firstNObservations sont bloquées pour l’ensemble des espaces de diffusion dédiés TiVA (sti-public) et CRS (dcd-public).
Pour l’espace principal de diffusion des données (public), ces paramètres sont bloqués uniquement pour les jeux de données de grande taille listés ci‑dessous.
| Agency ID | Dataset |
|---|---|
| OECD.SDD.TPS | DSD_BATIS@DF_BATIS |
| OECD.ENV.EPI | DSD_ECH@EXT_TEMP_P |
| OECD.STI.PIE | DSD_TIM_2023@DF_TIM_2023 |
| OECD.SDD.STES | DSD_STES_REVISIONS@DF_STES_REVISIONS |
| OECD.STI.PIE | DSD_TIM_2021@DF_TIM_2021 |
| OECD.SDD.TPS | DSD_BIMTS@DF_BIMTS_HS2017_2D |
| OECD.SDD.TPS | DSD_BIMTS@DF_BIMTS_CPA_2_1 |
| OECD.CFE.EDS | DSD_LA_EXTREME_TEMP_DDOWN@DF_EXTREME_TEMP_DDOWN |
| OECD.STI.PIE | DSD_TIMBC_2023@DF_TIMBC_2023 |
| OECD.EDU.IMEP | DSD_EAG_UOE_FIN@DF_UOE_FIN_INDIC_SOURCE_NATURE |
| OECD.CFE.EDS | DSD_LA_DEMO_POP_AGE_DDOWN@DF_POP_AGE_DDOWN |
| OECD.SDD.TPS | DSD_SDBSBSC_ISIC4@DF_SDBS_ISIC4 |
Ces jeux de données contiennent actuellement plus de 20 millions d’observations, et l’utilisation de ces paramètres, qui permettent le tri des données, peut générer des requêtes très lourdes ayant un impact sur les performances globales du système.
Les requêtes contenant ces paramètres renverront la réponse suivante :
413 – Entité de requête trop volumineuse
(La page n’a pas été affichée car l’entité de la requête est trop grande.)
Cette restriction s’applique uniquement aux appels API directs. L’utilisation interactive via la page web de l’ Explorateur des données de l'OCDE continuera de fonctionner normalement, y compris le filtre valeur(s) des séries temporelles disponible dans la sélection de la période.