Isoloir 2027
Point d'accès

État de la collecte

Le dernier passage, la dernière écriture et les erreurs de chaque relevé : de quoi savoir si les données sont à jour.

Mis à jour le 10 novembre 2026

GEThttps://isoloir2027.fr/api/v1/etat

Mise à jour : À chaque passage du collecteur, chaque heure. Format : JSON.

Ce que contiennent les données

Trois parties, followers, wikipedia et posts, chacune avec l'heure du dernier passage (lastRun), du dernier passage réussi (lastOk), de la dernière écriture de données (lastWrite), le nombre de lignes écrites au dernier passage (written) et la liste des erreurs rencontrées.

À interroger avant un traitement automatique : si lastOk date de plus de quelques heures, les chiffres des autres points d'accès ne sont pas frais, et errors dit quelle source a manqué.

Comment elles sont collectées

Écrit par le collecteur à la fin de chaque passage horaire. Un passage qui n'a rien à faire (les abonnés d'un compte déjà relevés dans les 6 heures) met à jour lastRun sans écrire de donnée, d'où written: 0.

Limites à connaître

  • Ce point d'accès décrit la collecte, pas la qualité des chiffres : un relevé réussi peut porter un chiffre arrondi par la plateforme.

Paramètres

Aucun paramètre : la réponse est toujours complète.

Requête

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

Réponse

Comme tous les points d'accès, la réponse JSON contient meta (point d'accès, date de génération, licence, source, avertissement) et data. Champs de data :

ChampTypeContenu
<partie>.lastRun, lastOk, lastWritestring (date-time)Dernier passage, dernier succès, dernière écriture.
<partie>.writtenintegerLignes écrites au dernier passage.
<partie>.errors[]arrayMessages des erreurs du dernier passage (30 au plus).
Réponse 200
{
  "meta": {
    "endpoint": "/api/v1/etat",
    "version": "v1",
    "generatedAt": "2026-11-10T19:21:01.098Z",
    "licence": {
      "name": "Creative Commons Attribution 4.0 (CC BY 4.0)",
      "url": "https://creativecommons.org/licenses/by/4.0/deed.fr",
      "attribution": "Isoloir 2027 (isoloir2027.fr)"
    },
    "docs": "https://isoloir2027.fr/donnees-ouvertes/api"
  },
  "data": {
    "followers": {
      "lastRun": "2026-11-10T19:02:39.352Z",
      "lastOk": "2026-11-10T19:02:39.352Z",
      "lastWrite": "2026-11-10T17:44:12.357Z",
      "written": 0,
      "errors": []
    },
    "wikipedia": {
      "lastRun": "2026-11-10T19:02:39.352Z",
      "lastOk": "2026-11-10T19:02:39.352Z",
      "lastWrite": "2026-11-10T04:30:02.972Z",
      "written": 0,
      "errors": []
    },
    "posts": {
      "lastRun": "2026-11-10T19:02:39.352Z",
      "lastOk": "2026-11-10T19:02:39.352Z",
      "lastWrite": "2026-11-10T19:03:11.530Z",
      "written": 1,
      "errors": []
    }
  }
}
Réponse réelle de l'API en production, le 10 novembre 2026 à 20 h 21 (heure de Paris), à la requête /api/v1/etat. textes de plus de 160 caractères abrégés par « … ».

Licence et attribution

Relevés et calculs d'Isoloir 2027 : CC BY 4.0. Couvert par les offres payantes.

Attribution : « Isoloir 2027 (isoloir2027.fr) », avec un lien vers le site ou la page de la donnée.

Le détail de chaque licence : licences et attribution.