Публичный API RiseOfServers отдаёт статус игровых серверов (CS2, DayZ, Rust, ARK, Minecraft, SAMP, GTA 5, ARMA 3 и другие) в реальном времени. API read-only, ключ для публичных данных не требуется.
Базовый URL
https://api.riseofservers.ru/api — все запросы идут по HTTPS.
Возвращается application/json в UTF-8. Ошибки соответствуют стандарту Laravel: HTTP 4xx/5xx и поле message, для валидации дополнительно errors.
Списки обёрнуты в {data: [...], meta: {total, per_page, current_page}}. Даты — ISO 8601 по Europe/Moscow.
Аутентификация
Публичные эндпоинты (списки серверов, карточки, гайды, новости) открыты без авторизации.
Запись и управление сервером (RCON, редактирование карточки, тарифы) требуют Bearer-токен Laravel Sanctum: заголовок Authorization: Bearer <token>. Токен выпускается после логина через /api/auth/login.
Лимиты
- 60 запросов в минуту с одного IP для неавторизованных клиентов.
- 600 запросов в минуту для авторизованных.
При превышении приходит HTTP 429 Too Many Requests с заголовком Retry-After. Нужен больший лимит — создайте обращение на странице поддержки с описанием сценария.
Политика использования
Некоммерческое использование с указанием источника и ссылкой на riseofservers.ru допускается.
Коммерческое использование, ресейл и скрапинг для автоматической агрегации — только по согласованию через страницу поддержки. Использование без атрибуции может привести к блокировке IP.
Поддержка
Вопросы по API, запросы на повышение лимита и сообщения о багах — через страницу поддержки. Укажите User-Agent, публичный IP, время запроса по МСК и тело запроса.