CHRONO GATE0 online
Ontwikkelaars
Publieke API-endpoints, ratelimieten en stabiliteitsbeloftes.

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.

GET/api/onlinePlatforms online

Geeft het huidige aantal online platforms in de vloot terug. Wordt gebruikt door onze landingspagina en door community-dashboards.

Antwoord
{
  "online": 42
}
Voorbeeld
curl -sS https://chronogate.io/api/online
GET/api/healthHealth check

Lichtgewicht liveness-probe geschikt voor uptime-monitors. Geeft HTTP 200 terug als alles goed is, HTTP 503 bij degradatie.

Antwoord
{
  "status": "ok"
}
Uitgebreide modus

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
}
Authenticatie

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.

Versionering & stabiliteit

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.

Ratelimieten

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.

Gebruiksvoorwaarden

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.

Partnerschappen & integraties

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.