Retry и dead-letter
Что считается успехом
Заголовок раздела «Что считается успехом»Успешная доставка требует HTTP 2xx. На запрос и чтение фрагмента ответа отводится 10 секунд. Для журнала доставок FlowWorker читает первые 8 КиБ тела ответа и сохраняет до 2 000 единиц UTF-16. После достижения лимита чтение прекращается.
Backoff schedule
Заголовок раздела «Backoff schedule»| Попытка | Задержка перед следующей |
|---|---|
| 1 → 2 | 1 минута |
| 2 → 3 | 5 минут |
| 3 → 4 | 30 минут |
| 4 → 5 | 2 часа |
| 5 (после 5-й fail) | DeadLettered |
Итого ~14.5 часов окно для восстановления вашего endpoint’а.
Dead letter
Заголовок раздела «Dead letter»После 5-й неудачной попытки доставка помечается DeadLettered и больше не повторяется. Её можно увидеть в UI: Webhooks → ваша подписка → Журнал доставок.
Manual retry
Заголовок раздела «Manual retry»Из UI или через management API: POST /api/v1/accounts/{a}/webhooks/{sub}/deliveries/{id}/retry. Сбрасывает статус в Queued, attempt в 0 - поэтому одна manual-попытка - это новые 5 попыток с backoff.
Auto-disable подписки
Заголовок раздела «Auto-disable подписки»Если у одной подписки 50 dead-letter доставок подряд - IsActive автоматически устанавливается в false. Это защита от мёртвых endpoint’ов, чтобы они не забивали очередь повторными неуспешными попытками.
В UI подписка отображается как “Отключена системой автоматически”. Чтобы возобновить: пометьте её активной через UI (или PATCH с isActive: true) - счётчик ConsecutiveDeadLetters сбрасывается в 0.
Журнал доставок
Заголовок раздела «Журнал доставок»Каждая попытка пишется в таблицу WebhookDeliveries. UI показывает: timestamp, тип события, статус (Succeeded/Failed/DeadLettered), HTTP status, фрагмент ответа, текст ошибки. Хранятся 30 дней.
API: GET /api/v1/accounts/{a}/webhooks/{sub}/deliveries?page=1&pageSize=50.
Idempotency на вашей стороне
Заголовок раздела «Idempotency на вашей стороне»Один event имеет одинаковый id во всех попытках доставки (1+ при retry). Каждая попытка имеет уникальный X-FlowWorker-Delivery. Используйте id для дедупликации: запишите processed_ids в своей БД и игнорируйте повторы.