На этой странице
Видео: фоновые задания1:07
  1. Создайте очередь

    Jobs → «Новая очередь»: имя (например, prices) и куда доставлять — сервис проекта с портом и путём или любой URL.

  2. Получите ключ

    Вкладка «Ключи и код» → «Новый ключ» (hjk_…). Сохраните его в переменной JOBS_KEY бэкенда.

  3. Поставьте задание

    POST https://api.hangar.rest/v1/jobs/publish/prices с ключом — Hangar доставит тело в ваш сервис и подпишет запрос.

  4. Ответьте 2xx

    Ответ 2xx — готово. Любой другой ответ или таймаут — повтор с паузой, до лимита попыток очереди.

Hangar Jobs
Обзор Jobs: задания в очереди и в работе, готово и ошибок за сутки, успешность и среднее время.

Очереди#

Очередь — адрес, куда Hangar доставляет задания HTTP-запросом: эндпоинт сервиса проекта (через внутренний канал, публичный адрес не нужен) или любой https-адрес. Для каждой очереди задаются параллельность, число повторов, пауза между ними (растёт вдвое) и таймаут.

Очереди
Очереди notifications и prices: куда доставляются задания, счётчики и лимиты (параллельно до 5, повторов 5, таймаут 60 с).

Задания#

Задание ставят из кода ключом workspace (Jobs → Ключи): POST /v1/jobs/publish/очередь, тело запроса — само задание. Можно отложить (?delay=15m) и не дублировать (?dedupe=ключ: пока задание с этим ключом ждёт, новое не создаётся). Ответ сервиса 2xx — готово; ошибка, таймаут или 5xx — Hangar повторит; Retry-After: N — повторит через N секунд.

Расписания#

Расписание ставит задание в очередь по cron: «0 * * * *» — каждый час, «*/5 * * * *» — каждые 5 минут, «0 9 * * mon-fri» — по будням в 9:00; поддерживаются @hourly, @daily и часовые пояса. Кнопка «Запустить сейчас» ставит задание сразу.

Расписания
Расписания: cron и часовой пояс, следующий запуск, «Запустить сейчас».

История и подпись#

Каждый запуск хранится 30 дней: статус, все попытки с кодом и временем ответа, тело и последний ответ; упавший можно повторить, ждущий — отменить. Запросы подписаны: Hangar-Signature = v1=hex(HMAC-SHA256(секрет очереди, Hangar-Timestamp + '.' + тело)); в SDK — verifySignature.

Терминал
curl -X POST "https://api.hangar.rest/v1/jobs/publish/prices?delay=5m" \
  -H "Authorization: Bearer $JOBS_KEY" -d '{"sku": 42}'

# в сервисе: заголовки Hangar-Message-Id, Hangar-Queue, Hangar-Attempt, Hangar-Signature
# SDK: https://api.hangar.rest/sdk/workflows.js и https://api.hangar.rest/sdk/workflows.py
История запусков
Запуски: статус, очередь, откуда пришло задание, попытки, ответ, время.
Запуск
Запуск notifications: попытка 1 — ответ 503, попытка 2 — 200. «Повторить» ставит задание заново.