Conditions
Changements
Tout ce qui change dans l'API, daté. La version 1 ne perd un champ ou un point d'accès qu'avec une annonce ici ; un changement qui casse les clients passe par une version 2.
Mis à jour le 10 novembre 2026
Journal
Data du jour : la page utile
- Nouveau champ
pageUtile(url,titre) dans la data du jour : la page du site qui explique le chiffre du jour.linkgarde sa place et donne la même adresse ; pour le fil des candidats, elle passe de la page du fil à la section du baromètre qui le présente.
- Nouveau champ
Comptes, clés et offres
- Comptes par e-mail (lien de connexion à usage unique) et clés personnelles, régénérables et révocables depuis Mon compte. Les clés s'activent dès que l'inscription est ouverte sur le serveur.
- Offres : Gratuit avec clé, Pro et Entreprise (tarifs), et conditions d'utilisation et de vente.
- Nouvel en-tête
X-Isoloir-Api-Plan: l'offre appliquée à la requête. Une clé inconnue ou révoquée reçoit 401invalid_api_key.
Clés, limites et documentation
- Documentation complète : une page par point d'accès, exemples de réponses réelles, fichier OpenAPI 3.1.
- En-têtes
RateLimit-Limit,RateLimit-Remaining,RateLimit-ResetetRateLimit-Policysur chaque réponse,Retry-Aftersur un 429. Les anciens en-têtesx-ratelimit-*restent envoyés. - Erreurs au format
{ "error": { "code", "status", "message", "docs" } }: le champstatusdéjà présent est conservé,codeetdocssont ajoutés. - Accès sans clé limité à 10 requêtes par minute et 60 par heure et par adresse (contre 60 par minute auparavant), annoncé comme transitoire par les en-têtes
DeprecationetSunset. - Une clé passée dans l'adresse (
?api_key=,?key=,?cle=) est refusée (400key_in_url). - Toute adresse inconnue sous
/api/v1/renvoie une erreur 404 en JSON. - Les sondages portent la licence CC BY-SA 4.0 de la liste Wikipédia dont ils sont tirés (
meta.licence).
Point d'accès retiré
- Un point d'accès de la version 1 a été retiré. Son adresse répond désormais 410 Gone avec un message, sans donnée. Les autres points d'accès ne changent pas.
Ouverture de l'API v1
- Mise en ligne de
/api/v1: candidats, baromètre, sondages, abonnés, Wikipédia, publications, signaux, état de la collecte et data du jour, en JSON et, pour trois d'entre eux, en CSV.
- Mise en ligne de