Isoloir 2027
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

  1. 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. link garde 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.
  2. 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 401 invalid_api_key.
  3. 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-Reset et RateLimit-Policy sur chaque réponse, Retry-After sur un 429. Les anciens en-têtes x-ratelimit-* restent envoyés.
    • Erreurs au format { "error": { "code", "status", "message", "docs" } } : le champ status déjà présent est conservé, code et docs sont 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 Deprecation et Sunset.
    • Une clé passée dans l'adresse (?api_key=, ?key=, ?cle=) est refusée (400 key_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).
  4. 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.
  5. 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.