Перейти к содержимому

Топ донатеров

GET /v1/stats/top · Секретный или публичный ключ · право stats:read

Донатеры с самой большой суммой донатов за сегодня, эту неделю, месяц, год или за всё время. Считаем донаты из всех подключённых источников и переводим в рубли. Донатеров с одним именем из разных источников считаем одним.

Загружаем справочник…

Параметры, ответы и поля таблицей
Имя Где Тип Описание
period в адресе строка, значения: DAY, WEEK, MONTH, YEAR, ALL_TIME, по умолчанию ALL_TIME DAY — сегодня с 00:00, WEEK — эта неделя с понедельника, MONTH — этот месяц, YEAR — этот год, ALL_TIME — всё время. Границы — по часовому поясу timeZone. По умолчанию ALL_TIME.
limit в адресе целое число, 1–100, по умолчанию 10 Сколько донатеров вернуть: от 1 до 100, по умолчанию 10.
timeZone в адресе строка, по умолчанию Europe/Moscow Часовой пояс, по которому считаются границы периода, например Asia/Novosibirsk. По умолчанию Europe/Moscow.
{
"period": "WEEK",
"from": "2026-11-08T21:00:00Z",
"to": "2026-11-15T21:00:00Z",
"items": [
{
"rank": 1,
"name": "Alex",
"total": {
"value": "12500.00",
"currency": "RUB"
}
},
{
"rank": 2,
"name": "Maria",
"total": {
"value": "4300.75",
"currency": "RUB"
}
},
{
"rank": 3,
"name": "Ivan",
"total": {
"value": "1000.00",
"currency": "RUB"
}
}
]
}
Поле Тип Описание
period строка, значения: DAY, WEEK, MONTH, YEAR, ALL_TIME Период из запроса.
from строка (дата и время) Начало периода. Для ALL_TIME — 1970-01-01T00:00:00Z.
to строка (дата и время) Начало следующего периода: сам этот момент в период не входит. Для ALL_TIME — момент ответа.
items список объектов
Поле Тип Описание
value строка Десятичная сумма с двумя знаками после запятой.
currency строка Код ISO 4217.