NIVLI SDK · публичный API v2

Базовый адрес: https://api.nivli.ru/api · формат JSON · авторизация Bearer-токеном

Сервисы

• api.nivli.ru — игровой и сайт-бэкенд (этот API).
• cdn.nivli.ru — раздача клиента, обновлений и лаунчера.
• lk.nivli.ru — личный кабинет игрока.
• UDP 27015–27018 — выделенные игровые серверы (собственный протокол, не HTTP).

Аутентификация

POST-запросы к /auth/register и /auth/login возвращают токен сроком 30 дней. Токен передаётся в заголовке Authorization: Bearer <token>. Токен подписан HMAC-SHA256 на стороне сервера.

Эндпоинты

• GET /health — статус сервиса.
• GET /news — лента новостей и патчноутов.
• GET /version — актуальная версия клиента и ссылки CDN.
• GET /leaderboard — топ-50 игроков по рейтингу.
• GET /me — профиль: ник, email, кредиты, статистика.
• GET /inventory · POST /inventory/buy · POST /inventory/equip — косметика.
• POST /mm/queue · GET /mm/status · POST /mm/leave — матчмейкинг (режимы: competitive, bhop, training).

Ограничения

Очередь авторизации — до 15 запросов за 10 секунд с одного IP, остальные эндпоинты — до 240. Превышение возвращает 429. Игровые серверы используют отдельный внутренний контур /gs/*, закрытый общим секретом, и не доступны из интернета напрямую.

Расширение API (турнирный контур, вебхуки для партнёров) — по мере развития проекта.