Статистика
Overview, series, breakdown, ranking и карточка ссылки.
GET /stats/{scope_id}/breakdown
Срез по одному измерению
Распределение выбранной метрики по одному измерению (`dimension`): top-N значений и опциональная строка `(other)` для хвоста. Отдельный запрос на каждый график дашборда.
Поведение
Параметры пути
Query-параметры
Ответы
GET /stats/{scope_id}/geo
Geo-карта кликов (страны / регионы РФ / hex)
Choropleth по странам (`mode=countries`), субъектам РФ (`mode=regions&country=RU`) или hex-теплокарта по координатам (`mode=hex`). Hex требует raw retention. Countries/regions доступны из agg (`clicks_by_country` / `clicks_by_region`).
Параметры пути
Query-параметры
Ответы
GET /stats/{scope_id}/overview
Overview scope/folder/short
Краткая сводка по кликам для scope, папки или одной ссылки: KPI, короткий дневной ряд, top-N срезы и (для scope/папки) топ ссылок. Один запрос при открытии экрана или ручном обновлении — **не** для polling.
Поведение
Параметры пути
Query-параметры
Ответы
GET /stats/{scope_id}/ranking
Топ сущностей внутри entity
Упорядоченная таблица топов за выбранное окно: ссылки, targets, UTM-кампании, referrers, страны и др. Удобна для таблиц дашборда и polling раз в ~60 с.
Поведение
Параметры пути
Query-параметры
Ответы
GET /stats/{scope_id}/series
Временной ряд под polling
Временной ряд метрик `(t, metrics…)` с гранулярностью `hour` или `day`. Рассчитан на **polling** дашборда (рекомендуемый интервал — не чаще раза в минуту).
Поведение
Параметры пути
Query-параметры
Ответы
GET /stats/{scope_id}/shorts/{short_id}
Карточка ссылки: lifetime + window
Детальная карточка одной ссылки: **lifetime**-показатели (доступны всегда, в том числе после очистки детальных кликов) и KPI выбранного окна с опциональным дневным рядом и срезами.
Поведение
Параметры пути
Query-параметры