Utiliser l’API publique
Ce tutoriel montre comment récupérer les nombres agrégés de la participation des usagers à Eusep par l’API publique.
Mis à jour le
1. Avant de commencer
- Aucun compte n’est nécessaire.
2. Étape par étape
-
Ouvrir la documentation de l’API publique
La documentation décrit chaque adresse de l’API.
La documentation de l’API publique. -
Choisir la participation par mois ou par département
Chaque adresse donne la participation de tous les mois ou de tous les départements, ou d’un seul mois ou d’un seul département.
Les adresses de l’API publique. -
Lire la réponse
Les réponses sont en JSON, 100 requêtes par heure et par adresse au plus (au-delà, la réponse est une erreur 429). Un effectif de 1 à 9 n’est jamais publié : il vaut null (« moins de 10 ») ; un département sous le seuil de 10 évaluations répond 404. Le document complet, lisible par les outils, est /eusep/api/openapi.json (OpenAPI 3).
Les règles de l’API : seuil de 10, limite de requêtes et mention de la source.
3. Pour aller plus loin
Seuil d’anonymat et points d’accès de l’API : voir la FAQ API publique.
4. Sources
Ce tutoriel décrit le site tel qu'il fonctionne à la date de mise à jour et s'appuie sur les documents publics suivants. Il ne constitue pas un conseil juridique personnel.