Bonnes pratiques pour l’utilisation de l’API

L’API de l’Explorateur de données de l’OCDE est soumise à une limitation du nombre de requêtes afin de protéger le réseau, de gérer efficacement le trafic et de garantir une expérience réactive pour tous les utilisateurs.

L'accès à l'API est actuellement soumis à une limite de 60 téléchargements de données par heure. Les requêtes dépassant cette limite seront temporairement bloquées. Cette restriction s'applique également aux téléchargements de fichiers CSV depuis l'interface web de data-explorer.oecd.org.

Par ailleurs, les requêtes provenant de VPN ou de sources anonymisées ne sont pas autorisées. Les requêtes provenant d'adresses IP identifiées comme potentiellement automatisées peuvent également déclencher un test de vérification (bot challenge).

Veuillez également noter que les requêtes API utilisant certains paramètres sont restreintes, car elles peuvent avoir un impact sur les performances globales du système. La liste des paramètres restreints est disponible ici.

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

Vous pouvez également interroger le catalogue complet des  contentconstraint pour l’ensemble des jeux de données disponibles. Le script Python présenté ci-dessous (en format .txt) identifie les jeux de données mis à jour au cours des dernières 24 heures en vérifiant leurs horodatages ValidFrom dans les réponses contentconstraint. Il exporte ensuite la liste des jeux de données concernés, accompagnés de leurs dates de mise à jour, dans un fichier Excel.

Télécharger le script Python

Cela vous permet d’identifier les jeux de données qui ont été mis à jour et de limiter les appels API à ces seuls jeux de données, afin d’éviter les requêtes inutiles.

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.