Гайды / Виджеты и API для кланов
Виджеты и API для кланов
Карточка клана на свой сайт и открытые данные.
Для сайтов кланов и ботов есть открытое API и готовые виджеты. Ключи и регистрация не нужны.
Виджет клана на свой сайт
- Лидер клана открывает страницу КВ и заходит в настройки клана.
- Включает «Публичный виджет и API клана» и сохраняет. По умолчанию выключено: без этого клан нигде не виден.
- В настройках появится готовый код
<iframe>. Вставь его на сайт клана.
Виджет показывает название, регион, число игроков и звания. Светлая тема включается добавлением ?theme=light к адресу.
Виджет игрока
https://stalbot.dev/embed/player/НИК показывает карточку игрока: ник, пометку о подтверждении, клан и значок подписки. Работает только для тех, кто не скрыл свою страницу.
Открытое API
/api/v1/player/{ник}— публичные данные игрока./api/v1/clans— кланы, открывшие данные./api/v1/clan/{id}— состав клана (ник и звание)./api/v1/clan/{id}/stats— сводка КВ: итоги, недели, лучшие игроки.
Лимит 60 запросов в минуту с одного адреса. Полное описание с примерами на странице «Для разработчиков».
Данные клана показываются только после того, как лидер сам включил виджет, и только название, регион и состав. Discord-серверы, каналы и настройки никогда не отдаются.