# Beget.API: задачи Cron

> Проверяйте расписание и команды задач Cron на хостинге Beget. API также позволяет добавлять, редактировать и отключать задания.

- HTML: https://poapi.ru/beget/upravlenie-cron-po-api
- Компания: Beget
- Страница компании: https://poapi.ru/company/beget
- Категории: Администрирование
- Сайт API: https://beget.com/ru/kb/api/beget-api
- Адрес API: https://api.beget.com/api
- Документация: https://beget.com/ru/kb/api/funkczii-upravleniya-cron

## Подключение и ограничения
- Авторизация: Включите доступ к API в панели хостинга и задайте отдельный пароль. Передавайте логин аккаунта как login, пароль API как passwd в POST по HTTPS. IP-ограничения панели действуют и для API.
- Ограничения: getList читает все задания CronTab аккаунта. add принимает minutes (0–59), hours (0–23), days (1–31), months (1–12), weekdays (0–7; 0 и 7 — воскресенье) и command. Созданное задание сразу активно. На все методы действует общий лимит 60 запросов в минуту на пользователя.

```bash
set -eu
# Задайте BEGET_LOGIN и BEGET_API_PASSWORD в окружении. Нужен jq.
response=$(curl --silent --show-error --fail --max-time 20 --request POST \
  'https://api.beget.com/api/cron/getList' \
  --data-urlencode "login=${BEGET_LOGIN:?Укажите логин аккаунта}" \
  --data-urlencode "passwd=${BEGET_API_PASSWORD:?Укажите пароль API}" \
  --data-urlencode 'output_format=json')

jq -e --arg row "${BEGET_CRON_ROW:?Укажите ID задания}" --arg command "${BEGET_CRON_COMMAND:?Укажите команду}" '
if .status != "success" or .answer.status != "success" then
  error((.error_code // .answer.errors[0].error_code // "Ошибка Beget.API") | tostring)
else
  [.answer.result[] | select((.row_number | tostring) == $row and .command == $command)]
  | if length == 1 then .[0] | {row_number, minutes, hours, days, months, weekdays, is_hidden}
    else error("Задание с такой командой не найдено однозначно") end
end
' <<<"$response"
```
- Результат: В answer.result приходит массив заданий. Скрипт проверяет row_number и точное значение command и выводит календарные поля и is_hidden. Запись считается сверенной, когда команда и показанное расписание совпали с ожидаемыми.
- Ошибки: При AUTH_ERROR проверьте логин, пароль API и ограничения по IP. При answer.status=error разберите answer.errors. При LIMIT_ERROR выясните, какого лимита достигли, прежде чем повторять запрос.
- Проверено по документации: 2026-11-22
- [Задачи Cron в Beget.API](https://beget.com/ru/kb/api/funkczii-upravleniya-cron)
- [Авторизация и формат ответа Beget.API](https://beget.com/ru/kb/api/obshhij-princzip-raboty-s-api)

## Описание
Раздел cron управляет планировщиком хостингового аккаунта. Перед переносом проекта можно сверить конкретное задание с ожидаемой командой и расписанием. getList возвращает их вместе с идентификатором row number. Для изменения и удаления задания используются отдельные методы.

## Когда использовать
- При переносе сайта получить текущий список расписаний и сверить команды с новым окружением.
- Панель обслуживания может показывать владельцу аккаунта ID и команду каждой задачи, чтобы найти устаревший запуск.
- Перед изменением расписания сохранить текущее состояние getList для последующего сравнения.

## Порядок интеграции
1. Запишите ID задания и точную ожидаемую команду из конфигурации. Задайте BEGET_CRON_ROW и BEGET_CRON_COMMAND.
2. Получите задания через cron/getList и найдите запись с таким row_number.
3. Проверьте команду и сопоставьте выведенные календарные поля с нужным расписанием. Исполнение подтверждайте по отдельному журналу задачи.

## Что проверить перед запуском
- Новая задача сразу активна. Сверяйте существующую запись чтением перед внесением изменений.
- is_hidden описан как признак состояния. Для проверки фактического запуска сравните расписание и журнал задачи.

## Связанные API
- [Beget.API: сайты и домены сайта](https://poapi.ru/beget/upravlenie-saytami-po-api): Получайте список сайтов, их каталогов и привязанных доменов вместе с параметрами PHP, HTTP и SSL.
- [Beget.API: сведения об аккаунте](https://poapi.ru/beget/upravlenie-akkauntom-po-api): Сверяйте тариф, использование ресурсов, лимиты и параметры сервера хостингового аккаунта через getAccountInfo.
