Limitation du taux d’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 limité à un maximum de 60 téléchargements de données par heure. Toute requête dépassant cette limite sera temporairement bloquée. Cette restriction s’applique également aux téléchargements de fichiers CSV depuis l’interface data-explorer.oecd.org.
Par ailleurs, le trafic provenant de VPN ou de sources anonymisées n’est pas autorisé.
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.
Bonnes pratiques pour l’utilisation de l’API
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.