Публичное API открыто без ключа и отдаёт JSON. Базовый адрес — https://api.riseofservers.ru.
Серверы
GET/api/servers
Список серверов мониторинга с фильтрами и постраничной выдачей.
| Параметр | Тип | Описание |
|---|---|---|
game |
строка или массив | Слаг игры: dayz, rust, minecraft. Можно передать несколько. |
region |
строка | Регион сервера. |
map |
строка или массив | Карта. |
type |
строка или массив | Тип сервера. |
tag |
строка или массив | Тег. |
search |
строка | Поиск по названию. |
max_ping |
число | Отсечь сервера с пингом выше указанного, 1–10000. |
only_online |
логический | Только сервера онлайн. |
free_slots |
логический | Только со свободными слотами. |
no_queue |
логический | Только без очереди. |
only_promoted |
логический | Только продвигаемые. |
include_stats |
логический | Добавить блок статистики в ответ. |
sort |
строка | popularity (по умолчанию), votes, players, ping, rating_score, rating_grade. |
direction |
строка | asc или desc, по умолчанию desc. |
per_page |
число | Размер страницы, 1–100, по умолчанию 20. |
page |
число | Номер страницы. |
Элемент ответа содержит id, name, slug, ip, port, current_players, max_players, ping, map, uptime_percent, region, description.
curl "https://api.riseofservers.ru/api/servers?game=dayz&only_online=1&per_page=20"
GET/api/servers/{id}
Карточка сервера по числовому идентификатору.
GET/api/servers/by-path/{game}/{slug}
Та же карточка по адресу, который используется на сайте, — например dayz/my-server.
GET/api/servers/{id}/players
Текущий список игроков. Полнота зависит от протокола: без RCON часть полей (ник, пинг) может быть недоступна — подробнее в статье про RCON.
GET/api/servers/{id}/online-history
История онлайна за период. Есть вариант с посуточной агрегацией:
GET/api/servers/{id}/online-history/daily
GET/api/servers/facets
Счётчики вариантов для панели фильтров: сколько серверов попадает под каждое значение. Принимает те же параметры, что и /api/servers.
GET/api/servers/stats
Сводная статистика мониторинга.
GET/api/games
Справочник поддерживаемых игр.
Контент
GET/api/guides
Список всех гайдов.
GET/api/guides/{game}
Гайды по конкретной игре.
GET/api/guides/{game}/{slug}
Карточка гайда.
GET/api/news
Список новостей.
GET/api/news/{slug}
Карточка новости.
GET/api/plans
Список тарифов.
Авторизация
POST/api/auth/login
Вход. Если у аккаунта включена двухфакторная защита, ответ потребует второй шаг — POST /api/auth/login/verify-2fa.
POST/api/auth/register
Регистрация.