Renvoie le nombre actuel de plates-formes en ligne dans la flotte. Utilisé par notre landing et par les tableaux de bord communautaires.

{
  "online": 42
}

curl -sS https://chronogate.io/api/online

Sonde de liveness légère adaptée aux moniteurs d’uptime. Renvoie HTTP 200 quand tout va bien, HTTP 503 en cas de dégradation.

{
  "status": "ok"
}

Avec un en-tête X-Health-Key valide, la réponse s’étend pour inclure la latence base de données, l’espace disque libre, la mémoire libre et l’uptime. La clé n’est pas publique ; demandez-la-nous si vous avez un besoin légitime de monitoring.

curl -sS -H "X-Health-Key: <your-key>" \
     https://chronogate.io/api/health

{
  "status": "ok",
  "checks": {
    "database": { "status": "ok", "latency_ms": 3 },
    "disk":     { "status": "ok", "free_mb": 8421 },
    "memory":   { "status": "ok", "free_mb": 743 }
  },
  "uptime_seconds": 123456
}

Les endpoints ci-dessus sont sans authentification. Les endpoints de télémétrie appareil (/api/heartbeat, /api/alert, /api/diagnostics et al.) utilisent des identifiants spécifiques à l’appareil, émis au provisioning, et ne font pas partie de l’API publique. Les endpoints de compte requièrent un cookie de session.

Nous ne versionnons pas ces endpoints aujourd’hui car la surface est minuscule et nous promettons de ne pas casser les noms de champs JSON. Tout changement cassant sera annoncé sur la page /changelog au moins 30 jours à l’avance.

Les limites sont par IP client et remises à zéro chaque minute. En cas de dépassement vous verrez HTTP 503 avec un corps JSON {"error":"rate limited"}. Faites un back-off et réessayez ; il n’y a pas de bannissement dur.

Identifiez votre client avec un User-Agent descriptif (par exemple « acme-dashboard/1.2 +https://example.com »). Ne scrapez pas les endpoints pour reconstruire une base que vous redistribueriez. Respectez les réponses HTTP 503 comme un signal pour ralentir.