Перейти к содержимому

Retry и dead-letter

Успешная доставка требует HTTP 2xx. На запрос и чтение фрагмента ответа отводится 10 секунд. Для журнала доставок FlowWorker читает первые 8 КиБ тела ответа и сохраняет до 2 000 единиц UTF-16. После достижения лимита чтение прекращается.

ПопыткаЗадержка перед следующей
1 → 21 минута
2 → 35 минут
3 → 430 минут
4 → 52 часа
5 (после 5-й fail)DeadLettered

Итого ~14.5 часов окно для восстановления вашего endpoint’а.

После 5-й неудачной попытки доставка помечается DeadLettered и больше не повторяется. Её можно увидеть в UI: Webhooks → ваша подписка → Журнал доставок.

Из UI или через management API: POST /api/v1/accounts/{a}/webhooks/{sub}/deliveries/{id}/retry. Сбрасывает статус в Queued, attempt в 0 - поэтому одна manual-попытка - это новые 5 попыток с backoff.

Если у одной подписки 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.

Один event имеет одинаковый id во всех попытках доставки (1+ при retry). Каждая попытка имеет уникальный X-FlowWorker-Delivery. Используйте id для дедупликации: запишите processed_ids в своей БД и игнорируйте повторы.