# Сумма донатов

**`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`](https://developers.donatty.com/errors/invalid_parameter.md), [`token_in_query`](https://developers.donatty.com/errors/token_in_query.md)
- `401` — Ключа нет, он не найден, удалён или истёк: [`missing_token`](https://developers.donatty.com/errors/missing_token.md), [`invalid_token`](https://developers.donatty.com/errors/invalid_token.md), [`token_expired`](https://developers.donatty.com/errors/token_expired.md)
- `403` — Ключ не того вида, у него нет права `stats:read`, или публичный ключ пришёл с адреса, которого нет в его списке: [`wrong_token_type`](https://developers.donatty.com/errors/wrong_token_type.md), [`insufficient_scope`](https://developers.donatty.com/errors/insufficient_scope.md), [`origin_not_allowed`](https://developers.donatty.com/errors/origin_not_allowed.md)
- `429` — Исчерпан лимит запросов: [`rate_limited`](https://developers.donatty.com/errors/rate_limited.md)
- `500` — Запрос не удался на нашей стороне: [`internal_error`](https://developers.donatty.com/errors/internal_error.md)
- `503` — API временно недоступен: [`service_unavailable`](https://developers.donatty.com/errors/service_unavailable.md)

## Пример ответа

```json
{
  "period": "DAY",
  "from": "2026-11-09T17:00:00Z",
  "to": "2026-11-10T17:00:00Z",
  "total": {
    "value": "18250.25",
    "currency": "RUB"
  }
}
```

## Схемы

### Total

| Поле | Тип | Описание |
|---|---|---|
| `period` | строка, значения: `DAY`, `WEEK`, `MONTH`, `YEAR`, `ALL_TIME` | Период из запроса. |
| `from` | строка (дата и время) | Начало периода. Для `ALL_TIME` — `1970-01-01T00:00:00Z`. |
| `to` | строка (дата и время) | Начало следующего периода: сам этот момент в период не входит. Для `ALL_TIME` — момент ответа. |
| `total` | `Money` | Сумма донатов за период в рублях. |

### Money

| Поле | Тип | Описание |
|---|---|---|
| `value` | строка | Десятичная сумма с двумя знаками после запятой. |
| `currency` | строка | Код ISO 4217. |
