Сумма донатов
GET /v1/stats/total · Секретный или публичный ключ · право stats:read
Сумма донатов за сегодня, эту неделю, месяц, год или за всё время. Считаем донаты из всех подключённых источников, включая отклонённые модерацией, и переводим в рубли.
Загружаем справочник…
Параметры, ответы и поля таблицей
Параметры
Заголовок раздела «Параметры»| Имя | Где | Тип | Описание |
|---|---|---|---|
period |
в адресе | строка, значения: DAY, WEEK, MONTH, YEAR, ALL_TIME, по умолчанию ALL_TIME |
DAY — сегодня с 00:00, WEEK — эта неделя с понедельника, MONTH — этот месяц, YEAR — этот год, ALL_TIME — всё время. Границы — по часовому поясу timeZone. По умолчанию ALL_TIME. |
timeZone |
в адресе | строка, по умолчанию Europe/Moscow |
Часовой пояс, по которому считаются границы периода, например Asia/Novosibirsk. По умолчанию Europe/Moscow. |
200— Успешно400— Параметр не подходит или ключ передан в адресе запроса:invalid_parameter,token_in_query401— Ключа нет, он не найден, удалён или истёк:missing_token,invalid_token,token_expired403— Ключ не того вида, у него нет праваstats:read, или публичный ключ пришёл с адреса, которого нет в его списке:wrong_token_type,insufficient_scope,origin_not_allowed429— Исчерпан лимит запросов:rate_limited500— Запрос не удался на нашей стороне:internal_error503— API временно недоступен:service_unavailable
Пример ответа
Заголовок раздела «Пример ответа»{ "period": "DAY", "from": "2026-11-09T17:00:00Z", "to": "2026-11-10T17:00:00Z", "total": { "value": "18250.25", "currency": "RUB" }}| Поле | Тип | Описание |
|---|---|---|
period |
строка, значения: DAY, WEEK, MONTH, YEAR, ALL_TIME |
Период из запроса. |
from |
строка (дата и время) | Начало периода. Для ALL_TIME — 1970-01-01T00:00:00Z. |
to |
строка (дата и время) | Начало следующего периода: сам этот момент в период не входит. Для ALL_TIME — момент ответа. |
total |
Money |
Сумма донатов за период в рублях. |
| Поле | Тип | Описание |
|---|---|---|
value |
строка | Десятичная сумма с двумя знаками после запятой. |
currency |
строка | Код ISO 4217. |