API и спецификации

Обзор REST API

Как интерфейс связан с экранами FlowForge и внешними запусками.

REST API — то, через что работает веб-интерфейс после входа и что используют внешние вызовы (webhook, опрос runId и т.п.) на том же адресе. Подробные адреса и файлы описания — в панели Внешние инструменты в редакторе и в разделе машиночитаемых описаний.

Когда это касается вас

Вы в браузере — после входа открываются флоу, секреты, ключи, ручной запуск; данные идут тем же API.

Другая система по ключу — с ключом afk_… (области webhook и/или mcp) и списком разрешённых диаграмм.

Гость по ссылке на форму — без входа в интерфейс; вам как автору важен slug; примеры и описания — в панели Внешние инструменты в редакторе (/app/flow) и в машиночитаемых описаниях.

Формат вызовов для другой системы

Машиночитаемое описание webhook и готовые ссылки — машиночитаемые описания API. Как устроен запуск и runId: рантайм, опрос статуса.

Справка по типам нод

Состав библиотеки в каталоге совпадает с палитрой в редакторе.

Если ответ API с ошибкой

Смотрите HTTP-код и поле message в ответе, если оно есть. 400 — неверные данные в запросе; 401 / 403 — нет доступа; 429 — слишком частые запросы; 5xxподдержка или контакты, с runId, временем (UTC) и id диаграммы.

См. также