- Скачайте SDK
Один файл без зависимостей:
hangar.jsилиhangar.py(вкладка «Как писать»). Опишите процесс функцией с шагами step.run. - Подключите приложение
Workflows → «Подключить приложение»: сервис проекта с портом и путём (например, /workflows). Секрет приложения положите в WORKFLOW_SECRET.
- Обновите функции
Кнопка «Обновить функции» спросит у приложения список процессов — они появятся на карточке.
- Запустите
Кнопка «Запустить» или из кода:
POST /v1/workflows/start/<приложение>/<функция>с ключом JOBS_KEY.

Как это устроено#
Workflow — функция в вашем сервисе, объявленная через Hangar SDK (один файл для JavaScript/TypeScript или Python). Hangar хранит результат каждого шага: функция вызывается заново с готовыми результатами и выполняет только следующий шаг. Поэтому после падения, деплоя или перезапуска сервиса процесс продолжается, а не начинается заново.
Шаги#
step.run(имя, функция) — шаг выполняется один раз, при ошибке повторяется с паузой. step.sleep(имя, '1h') — пауза от секунд до месяцев. step.waitForEvent(имя, { event, match, timeout }) — ждёт событие, например подтверждение пользователя, до 30 дней. Побочные эффекты — только внутри step.run, у каждого шага своё имя.

Подключение#
Добавьте эндпоинт в разделе Workflows («Подключить приложение»), положите выданный WORKFLOW_SECRET в переменные сервиса и нажмите «Обновить функции». Запуск — из панели или из кода: POST /v1/workflows/start/приложение/функция с ключом workspace; событие — POST /v1/workflows/events.
Контроль#
В панели видно каждый запуск и его шаги: результаты, ошибки, попытки, до какого времени спит или чего ждёт. Упавший запуск можно продолжить с упавшего шага, любой — отменить. История хранится 30 дней.
curl -o hangar.js https://api.hangar.rest/sdk/workflows.js
wf.define('process-document', async ({ input, step }) => {
const doc = await step.run('upload', () => upload(input.url))
const ok = await step.waitForEvent('approval', { event: 'document.approved', match: doc.id, timeout: '3d' })
await step.sleep('cool-down', '10m')
return await step.run('send', () => send(doc, ok))
})
await hangar.start('docs', 'process-document', { url })
await hangar.event('document.approved', { match: docId })


