Опрос статуса и ошибки интеграций
Webhook и аналогичные старты возвращают runId и не ожидают полного завершения флоу. Далее вызывающая система запросами к API получает статус рана и, по готовности, результат — часто с system.output.
Исходящий HTTP-запрос с платформы на URL клиента в типовом сценарии не применяется; статус и результат получают опросом по runId. В браузере ход выполнения может отображаться через SSE без дополнительного опроса со стороны страницы.
Частота опроса
- Первый запрос — через 1–2 секунды после старта для коротких процессов.
- Далее увеличивают паузу (2 → 4 → 8 секунд…) до 15–30 секунд, пока ран не завершится или не сработает таймаут.
- Для флоу длительностью часы — интервал в несколько минут, не каждую секунду.
Высокая частота запросов по одному runId может привести к ответу 429 (ограничение частоты) и избыточной нагрузке на сервис.
Двойные запуски
Повторная отправка того же HTTP-запроса на старт может дать два runId. При необходимости строгой идемпотентности дедупликацию выполняют на стороне клиента либо передают внешний идентификатор в теле, который флоу проверяет самостоятельно.
Типичные симптомы
| Что видите | Куда смотреть |
|---|---|
| 401 / 403 | Ключ afk_, область webhook, привязка к диаграмме |
| 400 | Тело запроса не совпало с system.trigger.input |
| Ран ошибка | Журнал в интерфейсе или ответ API по шагам нод |
| Долго в работе | Длительные шаги, ожидание внешней системы |
Обращение в поддержку
Укажите runId, идентификатор диаграммы (UUID) и её название, время (UTC) и фрагмент тела запроса без секретов. Сведения о версии продукта — при наличии. Каналы: поддержка, контакты.