Pour protéger le réseau de l’API de l’Explorateur des données de l'OCDE, gérer le trafic et garantir une expérience réactive pour tous les utilisateurs, une limitation du taux d’utilisation de l’API a été introduite en novembre 2024.

Les utilisateurs sont limités à un maximum de 20 requêtes par minute et 20 téléchargements de données par heure. Tout dépassement de cette limite entraînera un blocage temporaire. Le trafic provenant de VPN ou de sources anonymisées n’est pas autorisé.

Voici des suggestions pour optimiser vos requêtes API, en particulier si vous récupérez fréquemment les mêmes données. Veuillez noter que, sauf exceptions pour certaines données économiques à haute fréquence, la plupart des ensembles de données de l’OCDE sont mis à jour une ou deux fois par an seulement, ce qui signifie que les réponses de l’API restent relativement stables dans le temps.

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. Utiliser le paramètre UpdatedAfter

Ce paramètre permet de récupérer uniquement les observations qui ont été insérées, mises à jour ou supprimées depuis un moment précis (la colonne ACTION retourne les valeurs D=Supprimé, R=Remplacé).
La valeur temporelle peut être exprimée au format dateTime, incluant le fuseau horaire du client (ex. : 2015-12-31T23:59:59.9999-01:00).
L’utilisation de ce paramètre est fortement recommandée, car elle réduit le volume de données transférées et améliore l’efficacité pour les synchronisations fréquentes avec la base de données.

Lors de l'utilisation de UpdatedAfter, privilégiez le format CSV (les autres formats peuvent ne pas inclure les attributs associés à des niveaux supérieurs à la série temporelle) en ajoutant l'en-tête HTTP suivant à votre requête :

Accept = application/vnd.sdmx.data+csv;version=2.0

Exemple :
https://sdmx.oecd.org/public/rest/data/OECD.SDD.TPS,DSD_ALFS@DF_SUMTAB/?dimensionAtObservation=AllDimensions&UpdatedAfter=2024-11-15

3. 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.

4. 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.