GET

/api/status

Справочник API

Публичный статус сервиса и моделей. Ключ не нужен, запрос бесплатный. Отдельного GET /health у Zukko нет — используйте этот endpoint.

1Пример запроса

bash

curl https://api.zukko.pro/api/status
curl "https://api.zukko.pro/api/status?hours=24"

hours — окно статистики в часах, от 1 до 24, по умолчанию 6.

2Ответ

json

{
  "overall": "ok",
  "maintenance": null,
  "window_hours": 6,
  "checked_at": "2026-10-04T12:00:00.000Z",
  "models": [
    {
      "id": "claude-sonnet-5",
      "name": "Claude Sonnet 5",
      "enabled": true,
      "state": "ok",
      "latency_ms": 1840
    }
  ]
}

Поле	Описание
`overall`	`ok`, `degraded` (часть моделей со сбоями), `down` (не работает ни одна включённая модель) или `maintenance`
`maintenance`	текст о технических работах или `null`
`window_hours`	окно, за которое считана статистика
`checked_at`	время ответа, ISO 8601
`models[].id`, `models[].name`	ID и название текстовой модели
`models[].enabled`	включена ли модель
`models[].state`	`ok`, `degraded`, `down`, `unknown` (мало данных) или `disabled`
`models[].latency_ms`	среднее время ответа за окно; может быть `null`

Во время технических работ запросы к моделям получают 503 с кодом maintenance и заголовком Retry-After: 600, а overall равен maintenance.

3GET /api/gateway-status

Сводка по шлюзу целиком — то, что показывает страница статуса:

bash

curl "https://api.zukko.pro/api/gateway-status?timeframe=24h"

timeframe — 1h (по умолчанию), 24h или 7d. В ответе: healthy, avg_success_rate (доля успешных запросов, %), avg_latency_ms, requests_total, timeseries (число запросов по интервалам), status_override и admin_message_ru / admin_message_en на время технических работ.

4Для мониторинга

Проверка доступности: GET /api/status, ожидайте 200 и overall не равный down или maintenance.
Проверка конкретной модели: поле state в models.
Проверка своего ключа: GET /v1/balance с ключом — бесплатно и без вызова модели.

POST /v1/web-search

Ошибка: что делать