> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kalenich Stats

> Статистика активности Discord-серверов: от наглядной сводки до интеграции с вашим приложением.

Kalenich Stats собирает статистику сообщений в основных общих каналах Discord-серверов. Сервис помогает сравнивать активность серверов, следить за показателями каналов и готовить собственные отчёты на основе открытого API.

Веб-интерфейс показывает месячную статистику. Через API доступны также отдельные дни, последние семь дней и произвольные диапазоны до 31 дня.

> **[Открыть статистику](https://stats.kalenich.sbs/)**
>
> Выберите месяц, найдите сервер и сравните активность в таблице.

> **[Сделать первый запрос](/kalenich-stats/quickstart)**
>
> Получите JSON с показателями сервера без регистрации и API-ключа.

## Что можно получить

| Данные | Для чего использовать |
| - | - |
| Число сообщений по серверу и учтённым каналам | Дашборды, сравнения и регулярные отчёты |
| Месяц, день, семь дней или диапазон дат | Анализ активности за нужный период |
| Каталог серверов с номерами и Discord ID | Выбор сервера и сопоставление данных |
| Текущие иконки и баннеры | Оформление карточек серверов в вашем приложении |
| Статус и время создания отчёта | Проверка актуальности и полноты статистики |

## Как устроен сервис

Сборщик подготавливает отчёты, а сайт и API читают сохранённые результаты. Запрос к API сам по себе не запускает сбор и не обновляет данные из Discord.

Учитываются сообщения всех авторов, включая ботов, без фильтра по ролям, в настроенных основных общих каналах. API возвращает счётчики и сведения о каналах и серверах. Тексты сообщений и данные авторов не публикуются.

> [!NOTE]
>
> Показатель сервера отражает активность учтённых каналов. Его нельзя трактовать как число всех сообщений на всём Discord-сервере или количество уникальных участников.

## Два способа работы

### Через сайт

На [странице статистики](https://stats.kalenich.sbs/) выберите месяц, найдите сервер по названию или номеру и настройте сортировку по сообщениям либо номеру сервера. В таблице доступны показатели каналов, состояние отчёта и время обновления по Москве.

Сводка показывает сумму сообщений по актуальным отчётам и число серверов, для которых такие отчёты доступны.

### Через API

Публичные методы доступны по HTTPS и возвращают JSON:

| Метод | Назначение |
| - | - |
| [`GET /api/discord-statistics`](/kalenich-stats/statistics) | Статистика одного сервера или всего каталога |
| [`GET /api/discord-icons`](/kalenich-stats/icons) | Текущие иконки и баннеры одного сервера или всего каталога |

Авторизация не требуется. Поддерживаются `GET` и `HEAD`; для получения тела JSON используйте `GET`.

> [!WARNING]
>
> Междоменные браузерные запросы (CORS) не включены. Если ваш сайт работает на другом домене, обращайтесь к API через собственный сервер.

## Как читать результаты

Календарные границы периодов определяются по `Europe/Moscow`. Данные обновляются проходами сборщика, поэтому время создания отчёта важнее времени вашего запроса.

Проверяйте `status` у каждого сервера и `complete` у общего ответа. Значение `null` означает отсутствие пригодного отчёта, а не нулевую активность. Итоговая сумма общего ответа учитывает только серверы со статусом `ok`.

> **[Периоды и даты](/kalenich-stats/periods)**
>
> Московское время, границы диапазонов и доступность истории.

> **[Данные и статусы](/kalenich-stats/data-and-statuses)**
>
> Схема ответа, свежесть отчётов и правила расчёта итогов.

> **[Ошибки API](/kalenich-stats/errors)**
>
> HTTP-коды, ошибки параметров и обработка сбоев.

> **[Примеры интеграции](/kalenich-stats/examples)**
>
> Запросы на JavaScript и Python, рейтинг серверов и обработка данных.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.