APIЭндпоинты
Сервер
Идентификатор и текущий статус сервера, к которому привязан ключ.
Отдаёт идентификатор и текущий статус сервера, к которому привязан ключ, — удобно как быстрая проверка, что ключ рабочий и сервер на связи.
Эндпоинт
GET https://api.wardencore.ru/v1/server
Авторизация
Нужен скоуп server:read. Ключ без него получает 403 insufficient_scope.
GET /v1/server HTTP/1.1
Host: api.wardencore.ru
Authorization: Bearer wc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxОтвет
200 OK — application/json:
{
"server_id": "clx9f2c…",
"name": "Мой SCUM-сервер",
"online": true,
"player_count": 12,
"mod_version": "2.0.99"
}| Поле | Тип | Описание |
|---|---|---|
server_id | string | Стабильный идентификатор сервера (ключ привязан именно к нему). |
name | string | null | Отображаемое имя из панели. null, если не задано. |
online | boolean | Всегда true в ответе 200 — см. ниже. |
player_count | integer | null | Игроков сейчас онлайн. null, если мод не сообщает это. |
mod_version | string | null | Версия запущенного мода WardenCore (напр. 2.0.99). |
Статус в реальном времени
Эндпоинт проксирует запрос к моду WardenCore на вашем сервере по живому
соединению. Если сервер офлайн — возвращается 503 server_unavailable
(с заголовком Retry-After), а не online: false. Поэтому ответ 200 всегда
означает, что сервер доступен. См. Доступность сервера.
Ошибки
Стандартный конверт ошибок. Самые вероятные:
| Код | Статус | Когда |
|---|---|---|
unauthorized | 401 | Ключ отсутствует, повреждён, истёк или отозван. |
insufficient_scope | 403 | У ключа нет server:read. |
server_unavailable | 503 | Игровой сервер офлайн или недоступен. |
gateway_timeout | 504 | Сервер не ответил вовремя. |