Гарантии доставки

Доставка вебхуков — best-effort: База старается отправить каждый запрос сразу после ответа пользователю, но не пересказывает доставку при сбоях.

#Что это значит

• Запросы отправляются после ответа на исходный вызов — они не задерживают пользователя.
• Таймаут на отправку — 5 секунд.
• При ошибке сети или не-2xx ответе событие не повторяется.
• Очередь сообщений и журнал доставки появятся позже.

#Рекомендации интегратору

• Отвечайте 2xx как можно быстрее (например, ставьте задачу в очередь).
• Сделайте обработку идемпотентной — ключом можно взять event + data.id + at.
• Для критичных сценариев периодически сверяйтесь с API v1: вебхук — сигнал, API — источник правды.