Для разработчиков

Открытое API и виджеты для сайтов кланов и ботов. Регистрация и ключи не нужны. Данные только те, что люди и кланы сами сделали публичными.

Правила

Только чтение (GET). Ответы в JSON, читать можно с любого сайта (CORS открыт).
Не больше 60 запросов в минуту с одного адреса. Ответы кэшируются на минуту.
Игрок виден, если подтвердил ник и не скрыл страницу. Клан виден, если лидер включил «Публичный виджет и API» в настройках клана на странице КВ.
Если используешь данные у себя, укажи источник: stalbot.dev.

Игрок

GET /api/v1/player/{ник}

curl https://stalbot.dev/api/v1/player/Vkt

{
  "ok": true,
  "nick": "Vkt",
  "verified": true,
  "region": "EU",
  "clan": {"name": "…", "tag": "", "rank": "Офицер"},
  "alliance": "…",
  "last_login": "2026-10-16T01:17:00Z",
  "subscription": "full",
  "member_since": 1760000000
}

clan есть, только если игрок состоит в клане, который ведётся на сайте. subscription (null, "mini" или "full") есть, если игрок не скрыл значок.

Кланы

GET /api/v1/clans — список кланов, открывших данные.
GET /api/v1/clan/{id клана} — название, регион, число игроков, звания и полный состав (ник и звание).
GET /api/v1/clan/{id клана}/stats?days=30 — сводка КВ: итоги, недели, лучшие игроки.

Id клана тот же, что в игре (он указан в ссылке на страницу клана и в настройках клана).

fetch("https://stalbot.dev/api/v1/clan/ID_КЛАНА")
  .then(r => r.json())
  .then(d => console.log(d.clan.name, d.clan.members_count));

Виджеты

Готовые карточки для вставки на сайт. Параметр ?theme=light включает светлую тему.

<iframe src="https://stalbot.dev/embed/clan/ID_КЛАНА" width="360" height="240" style="border:0"></iframe>

<iframe src="https://stalbot.dev/embed/player/НИК" width="320" height="120" style="border:0"></iframe>

Ошибки

`404`	игрок или клан не найден, скрыт или не открыл данные
`429`	слишком много запросов

Как открыть данные клана

Лидер клана открывает страницу КВ, раздел настроек клана.
Включает «Публичный виджет и API клана» и сохраняет.
В настройках появится готовый код для вставки.