Расписания
Расписание (schedule) позволяет настроить автоматическое обновление отчёта через заданные интервалы времени без ручного запуска.
Конфигурация
Расписание задаётся объектом в параметре schedule отчёта:
json
{
"schedule": {
"enabled": true,
"interval": "daily",
"time": "06:00",
"timezone": "Europe/Moscow",
"days_of_week": [1, 2, 3, 4, 5],
"day_of_month": 1,
"retry_on_failure": true,
"max_retries": 3
}
}Параметры расписания
| Параметр | Тип | Обязательное | Описание |
|---|---|---|---|
enabled | boolean | Да | Включено ли расписание |
interval | строка | Да | Периодичность запуска |
time | строка | Да | Время запуска в формате HH:MM |
timezone | строка | Нет | Часовой пояс времени запуска |
days_of_week | массив чисел | Нет | Дни недели (1=Пн, 7=Вс) для weekly |
day_of_month | число | Нет | День месяца (1–28) для monthly |
retry_on_failure | boolean | Нет | Повтор при ошибке (по умолчанию true) |
max_retries | число | Нет | Максимум повторов (по умолчанию 3) |
Интервалы
| Интервал | Описание | Дополнительные параметры |
|---|---|---|
hourly | Каждый час | Нет |
daily | Каждый день | Нет |
weekly | Раз в неделю | days_of_week |
biweekly | Раз в две недели | days_of_week |
monthly | Раз в месяц | day_of_month |
Примеры
Ежедневно в 6 утра
json
{
"schedule": {
"enabled": true,
"interval": "daily",
"time": "06:00",
"timezone": "Europe/Moscow"
}
}По будням в 8:00
json
{
"schedule": {
"enabled": true,
"interval": "weekly",
"time": "08:00",
"days_of_week": [1, 2, 3, 4, 5],
"timezone": "Europe/Moscow"
}
}Первого числа каждого месяца
json
{
"schedule": {
"enabled": true,
"interval": "monthly",
"time": "00:00",
"day_of_month": 1,
"timezone": "Europe/Moscow"
}
}Поведение при ошибках
При включённом retry_on_failure:
- Запуск по расписанию → ошибка
- Пауза 5 минут → повторная попытка 1
- Пауза 15 минут → повторная попытка 2
- Пауза 30 минут → повторная попытка 3
- Все попытки исчерпаны → статус отчёта
failed
Если retry_on_failure: false — при первой ошибке статус сразу failed.
Пропущенные запуски
Если система была недоступна в момент запланированного запуска:
- Пропущенный запуск не выполняется при восстановлении
- Следующий запуск — по обычному расписанию
Исключение: для daily и hourly, если окно пропуска меньше интервала, запуск выполняется сразу при восстановлении.
Ограничения по тарифам
| Тариф | Максимум расписаний | Минимальный интервал |
|---|---|---|
| Free | Расписания недоступны (только ручной запуск) | — |
| Solo | 20 | daily |
| Agency | 100 | hourly |
| Agency Pro | Без ограничений | hourly |
Ручной перезапуск
Расписание не блокирует ручной запуск. Можно запустить отчёт вручную в любое время независимо от расписания.