É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
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 :
| Champ | Type | Contenu |
|---|---|---|
<partie>.lastRun, lastOk, lastWrite | string (date-time) | Dernier passage, dernier succès, dernière écriture. |
<partie>.written | integer | Lignes écrites au dernier passage. |
<partie>.errors[] | array | Messages des erreurs du dernier passage (30 au plus). |
{
"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": []
}
}
}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.