We houden het publieke API-oppervlak bewust klein. De endpoints hieronder zijn stabiel en veilig voor community-integraties. Apparaat- en accountendpoints hebben hun eigen authenticatie en zijn niet publiek.
Geeft het huidige aantal online platforms in de vloot terug. Wordt gebruikt door onze landingspagina en door community-dashboards.
{
"online": 42
}curl -sS https://chronogate.io/api/onlineLichtgewicht liveness-probe geschikt voor uptime-monitors. Geeft HTTP 200 terug als alles goed is, HTTP 503 bij degradatie.
{
"status": "ok"
}Met een geldige X-Health-Key request-header breidt het antwoord uit met database-latency, vrije schijfruimte, vrij geheugen en uptime. De sleutel is niet publiek; vraag hem aan als u een legitieme monitoringbehoefte hebt.
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
}De bovenstaande endpoints zijn zonder authenticatie. Apparaattelemetrie-endpoints (/api/heartbeat, /api/alert, /api/diagnostics enzovoort) gebruiken apparaat-scoped credentials die tijdens provisioning worden uitgegeven en maken geen deel uit van de publieke API. Account-scoped endpoints vereisen een sessiecookie.
We versioneren deze endpoints vandaag niet omdat het oppervlak klein is en we beloven geen JSON-veldnamen te breken. Elke breaking change wordt minstens 30 dagen vooraf aangekondigd op de /changelog-pagina.
Limieten zijn per client-IP en worden elke minuut gereset. Bij overschrijding ziet u HTTP 503 met JSON-body {"error":"rate limited"}. Back-off en probeer opnieuw; er is geen harde ban.
Identificeer uw client met een beschrijvende User-Agent (bijvoorbeeld “acme-dashboard/1.2 +https://example.com”). Scrape endpoints niet om een database te herbouwen die u vervolgens verspreidt. Respecteer HTTP 503-antwoorden als signaal om te vertragen.
Bouwt u iets bovenop Chrono Gate? We horen er graag over en kunnen limieten vaak verhogen of meer gegevens delen in het kader van een overeenkomst.