Возвращает текущее число онлайн-платформ по флоту. Используется нашей landing-страницей и community-дашбордами.

{
  "online": 42
}

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

Лёгкий liveness-пробник, пригодный для uptime-мониторов. Возвращает HTTP 200 при норме, HTTP 503 при деградации.

{
  "status": "ok"
}

С валидным заголовком X-Health-Key ответ расширяется и включает латентность БД, свободное место на диске, свободную память и uptime. Ключ непубличный; запросите его, если у вас есть легитимная потребность в мониторинге.

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
}

Эндпоинты выше — без аутентификации. Эндпоинты телеметрии устройств (/api/heartbeat, /api/alert, /api/diagnostics и другие) используют устройственные учётные данные, выдаваемые при provisioning, и не входят в публичное API. Аккаунтные эндпоинты требуют session cookie.

Мы не версионируем эти эндпоинты сегодня, потому что поверхность мала, и обещаем не ломать имена JSON-полей. О любом breaking change мы объявим на странице /changelog минимум за 30 дней.

Лимиты — на IP клиента, сбрасываются каждую минуту. При превышении вы получите HTTP 503 с JSON-телом {"error":"rate limited"}. Сделайте back-off и повторите; жёстких банов нет.

Указывайте ваш клиент с описательным User-Agent (например, «acme-dashboard/1.2 +https://example.com»). Не скрейпьте эндпоинты, чтобы перестроить базу и затем распространять её. Ответы HTTP 503 — сигнал к замедлению, уважайте их.