Право read для всех методов этой страницы.
Метрики — GET /servers/{id}/metrics?range=1h
Нужен подключённый агент мониторинга (ставится галочкой «Мониторинг сервера» при заказе или в «Установить ещё ПО»).
| Параметр | Значение |
|---|---|
range | 1h (шаг 1 мин), 6h, 24h (шаг 10 мин), 7d (шаг 1 ч) |
{"ok": true, "metrics": {"connected": true, "status": "up", "range": "1h", "available": true, "points": [{"time": 1789733700, "cpu": 12.4, "memory": 1.8, "memory_total": 3.8, "disk": 9.1, "disk_total": 24.5, "rx": 0.42, "tx": 1.13, "interval": 60}]}}
| Поле точки | Описание |
|---|---|
time | момент замера |
cpu | загрузка, % |
memory, memory_total | занято / всего, ГиБ |
disk, disk_total | занято / всего, ГиБ |
rx, tx | входящий / исходящий трафик, Мбит/с |
interval | шаг между точками, с |
Без агента: {"connected": false, "status": "not_connected", "points": [], "available": false}. Агент молчит: status: "down". Значения кэшируются на 60 с.
Журнал событий — GET /servers/{id}/events
| Параметр | Значение |
|---|---|
limit | 1–300, по умолчанию 100 |
category | фильтр: power, access, security, billing, alert, schedule, software, network, system |
before | id события — вернуть более старые (постраничная загрузка) |
{"ok": true, "events": [{"id": 512, "category": "power", "category_title": "Питание", "color": "#2f6bff", "level": "info", "message": "Перезагрузка", "detail": "через API-токен «cron»", "actor": "Вы", "created_at": 1789733705}, {"id": 511, "category": "alert", "category_title": "Нагрузка", "color": "#d9481c", "level": "warn", "message": "Высокая нагрузка CPU", "detail": "92% последние 5 минут", "actor": "мониторинг", "created_at": 1789730000}], "categories": {"power": {"title": "Питание", "color": "#2f6bff"}, "security": {"title": "Безопасность", "color": "#e0532f"}}}
level: info, warn, error. actor: кто инициировал — вы, друг с доступом, планировщик, автопродление, мониторинг, администратор.
Уведомления — GET /notifications
| Параметр | Значение |
|---|---|
limit | 1–100, по умолчанию 30 |
before | id — более старые |
{"ok": true, "notifications": [{"id": 3, "category": "money", "category_title": "Оплата и баланс", "color": "#1a9c5b", "icon": "wallet", "title": "Осталось 3 дн. · web-prod", "body": "Оплачен до 21.09.2026, продление 1 090 ₽.", "server_id": 1, "link": "#servers/1", "read": false, "created_at": 1789733705}], "unread": 1, "categories": {"server": {"title": "Сервер", "color": "#2f6bff"}, "money": {"title": "Оплата и баланс", "color": "#1a9c5b"}}}
Категории: server, money, security, alert, support, schedule, news, system. Отметить прочитанными через API нельзя (только в кабинете) — используйте read и created_at у себя.
Установленное ПО и квота радара — GET /servers/{id}/other
{"ok": true, "software": {"recipe": "[\"docker\", \"3x-ui\"]", "recipes": ["docker", "3x-ui"], "name": "Docker CE + Compose, 3x-ui", "status": "complete", "detail": "Установлено.", "apps": [{"id": "3x-ui", "name": "3x-ui", "status": "complete"}]}, "radar_quota": {"limit": 240, "remaining": 212, "next_reset": 1789737600}}
software.status: none, queued, running, complete, partial, failed, needs_review, cancelled. Доступы к панелям (логины/пароли) через API не отдаются.
SSH-ключи на сервере — GET /servers/{id}/ssh-keys
{"ok": true, "supported": true, "keys": [{"id": 4, "title": "my-laptop", "type": "ssh-ed25519", "fingerprint": "SHA256:…", "installed": true}]}
supported: false — Windows-сервер. Установка ключей и управление профилем — только из кабинета.