Bonnes pratiques pour l’utilisation de l’API

Afin de protéger le réseau de l’API de l’Explorateur de données de l’OCDE, de gérer efficacement le trafic et de garantir une expérience réactive pour l’ensemble des utilisateurs, un mécanisme de limitation du débit a été mis en place en novembre 2024.

L’accès à l’API est actuellement limité à un maximum de 20 téléchargements de données par heure. Toute requête dépassant ce seuil entraînera un blocage temporaire. Par ailleurs, le trafic provenant de VPN ou de sources anonymisées n’est pas autorisé.

L’OCDE travaille activement à un assouplissement de ces restrictions. Celui-ci sera rendu possible grâce à des mises à niveau prévues de l’infrastructure, visant à améliorer la gestion de charges plus élevées et la simultanéité des accès. Toutefois, cette transition devrait encore prendre plusieurs mois.

Les recommandations suivantes visent à encourager une utilisation plus efficace de l’API de l’Explorateur de données de l’OCDE, en particulier pour les utilisateurs accédant régulièrement aux mêmes ensembles de données.

À quelques exceptions près — notamment pour les indicateurs économiques à haute fréquence — la plupart des ensembles de données de l’OCDE sont actualisés de manière peu fréquente (les révisions intervenant généralement une à deux fois par an). Par conséquent, les réponses de l’API restent relativement stables dans le temps. La mise en œuvre de stratégies de requêtage efficaces permet de limiter les demandes répétées inutiles et de réduire la nécessité de téléchargements à grande échelle.

1. Utiliser la requête contentconstraint

Cette requête fournit un horodatage ValidFrom, indiquant la date de la dernière mise à jour, ainsi qu'une annotation avec le nombre total d'observations. Il garantit également que vous recevez la dernière version de l’ensemble de données, vous permettant de vérifier si la version a changé.

Exemple :
https://sdmx.oecd.org/public/rest/contentconstraint/OECD.ELS.SPD/CR_A_DSD_SOCX_AGG@DF_SOCX_AGG/
https://sdmx.oecd.org/public/rest/ + contentconstraint/ + AGENCY_ID + CR_A_ + DATASET_ID

2. Mettre en cache vos résultats localement

Si vous ou plusieurs utilisateurs de la même organisation récupérez fréquemment les mêmes données, stockez les résultats localement dans une base de données ou un fichier.
Cela évite les requêtes redondantes, réduit la charge sur le serveur et prévient le dépassement des limites d’utilisation de l’API.

3. Optimiser la taille des requêtes

Effectuez des requêtes consolidées plus larges lorsque cela est possible, plutôt que de multiples petites requêtes.
Pour les ensembles de données très volumineux (par exemple, ceux contenant plus de 10 millions d’enregistrements), envisagez de diviser les requêtes en segments plus petits pour une meilleure gestion.

Merci de suivre ces bonnes pratiques afin de garantir une utilisation efficace et fiable de l’API.