Aller au contenu

API publique

L’API publique donne accès, sans aucun nom, à la participation des usagers à Eusep : nombre d’évaluations par mois et par département.

Mis à jour le

1. L’essentiel

Que montre l’API publique ?

Le nombre d’évaluations déposées, mois par mois sur les 12 derniers mois et par département (documentation).

Pourquoi voit-on « moins de 10 » ?

Pour protéger chacun : aucun nombre de 1 à 9 n’est publié ; dans la réponse JSON, il vaut null, ce qui signifie « moins de 10 ». Un département qui compte moins de 10 évaluations n’est pas détaillé : son adresse répond 404.

Ces chiffres contiennent-ils des données personnelles ?

Non : uniquement des nombres agrégés, sans nom, sans courriel et sans commentaire.

2. L’API publique

Qu’est-ce que l’API publique ?

Un accès en lecture seule, au format JSON, aux mêmes nombres agrégés, pour les outils et les chercheurs. Sa documentation décrit chaque adresse.

Y a-t-il une limite d’usage ?

Oui : 100 requêtes par heure et par adresse ; au-delà, l’API répond « trop de requêtes » (code 429).

3. Pour aller plus loin

Méthode

Seuil d’anonymat : 10 (règle dite de « k-anonymat » : un nombre n’est publié que s’il regroupe au moins 10 évaluations). Les évaluations masquées par la modération ne sont pas comptées. Le tableau mensuel couvre les 12 derniers mois.

Points d’accès

Participation mensuelle (ensemble et par mois AAAA-MM, dans les 12 derniers mois), participation par département (ensemble et par code de département). La description technique complète est publiée au format OpenAPI 3 sur la documentation de l’API.

4. Sources

Les réponses de cette page s'appuient sur les documents publics suivants. En cas de doute, ces documents font foi. Ces réponses décrivent le fonctionnement du site : elles ne constituent pas un conseil juridique personnel.