Isoloir 2027
Démarrer

Authentification

Une clé identifie votre usage et lui applique les quotas de votre offre. Elle voyage dans un en-tête HTTP, jamais dans l'adresse.

Mis à jour le 10 novembre 2026

Envoyer la clé

Deux en-têtes sont acceptés, au choix. Authorization: Bearer est la forme standard, comprise par la plupart des clients HTTP ; X-Api-Key est plus simple à saisir dans un tableur ou un outil sans réglage d'authentification.

curl "https://isoloir2027.fr/api/v1/barometre" \
  -H "Authorization: Bearer $ISOLOIR_API_KEY"

Une clé passée dans l'adresse (?api_key=, ?key=, ?cle=, ?apikey=) est refusée avec l'erreur 400 key_in_url, même si elle est valide : une adresse finit dans les journaux des serveurs, les historiques de navigation et les outils d'analyse. Si cela vous est arrivé, régénérez la clé.

Obtenir une clé

Une clé s'obtient avec une adresse e-mail, sans mot de passe : un lien de connexion à usage unique ouvre un tableau de bord où la clé est créée, régénérée ou révoquée, avec l'usage du jour et des 30 derniers jours. La clé complète n'est affichée qu'une fois, à sa création : Isoloir n'en garde que l'empreinte (SHA-256) et les douze premiers caractères, pour que vous la reconnaissiez. C'est sur la page Mon compte ; les offres sont sur la page tarifs.

Une clé ressemble à iso_ suivi de 43 caractères. Gardez-la côté serveur, dans une variable d'environnement : l'API répond à tous les sites (CORS ouvert), donc une clé placée dans du code servi aux visiteurs serait lisible par chacun d'eux.

Ce que dit la réponse

L'en-tête X-Isoloir-Api-Plan donne l'offre appliquée (anonyme, gratuit, pro, entreprise). Quand une clé est envoyée, X-Isoloir-Api-Key dit ce qu'il en est advenu :

  • valid : la clé est reconnue, les quotas de son offre s'appliquent ;
  • not-enabled : les clés ne sont pas encore actives sur le serveur ; la requête est traitée comme un appel sans clé ;
  • unverified : la base des clés est momentanément injoignable et cette clé n'a pas été vue récemment ; la requête passe avec les limites sans clé plutôt que d'échouer.

Une clé inconnue ou révoquée reçoit 401 invalid_api_key, sans que la requête soit traitée : une faute de frappe ne fait pas basculer en silence sur les limites sans clé.

Fin de l'accès sans clé

À son ouverture, l'API s'appelait sans clé, avec 60 requêtes par minute et 5 000 par jour. Depuis l'arrivée des clés, l'accès sans clé est limité à 10 par minute et 60 par heure par adresse IP, et chaque réponse sans clé l'annonce par trois en-têtes standard :

En-têtes
Deprecation: @1794268800
Sunset: Mon, 01 Feb 2027 00:00:00 GMT
Link: <https://isoloir2027.fr/donnees-ouvertes/api/authentification>; rel="deprecation"; type="text/html"

Deprecation (RFC 9745) date l'annonce, le 10 novembre 2026 ; Sunset (RFC 8594) donne la date de fin, le 1er février 2027. À partir de cette date, un appel sans clé recevra 401 api_key_required, mais seulement si l'inscription est ouverte : tant qu'une clé ne peut pas s'obtenir, l'accès sans clé continue aux limites ci-dessus. La date ne sera jamais avancée ; si elle doit être repoussée, l'en-tête Sunset et la page changements le diront.