PORTcore
+7 900 228-04-13

Доставка webhook с контролем повторов

Надёжная обработка webhook: очереди, повторы и сверка

Проектируем приём и отправку событий так, чтобы сбои можно было обнаружить, повторить и сверить с источником.

Надёжная обработка webhook: очереди, повторы и сверка: согласованное соединение программных систем. PORTcore — portcore.ru.
Иллюстрация к услуге «Надёжная обработка webhook: очереди, повторы и сверка».

Контур обработки

Проверяем подпись, сохраняем исходное событие и отвечаем источнику. Бизнес-операция выполняется в очереди с ключом идемпотентности. Отдельно учитываем порядок событий и позднее получение старого состояния.

Надёжная обработка webhook: очереди, повторы и сверка: webhook сначала сохраняется, затем обрабатывается. Схема PORTcore — portcore.ru.
Webhook сначала сохраняется, затем обрабатывается. Повторная доставка одного события не должна повторять бизнес-операцию. Долгая обработка отделена от быстрого подтверждения приёма.

Абсолютной гарантии внешней доставки сеть не даёт. Практическая задача — подтвердить приём, сохранить событие и обеспечить повторяемую обработку без дублирования результата.

Одно событие может приехать дважды

Внешняя система вправе повторить уведомление, если не получила своевременный ответ. Приёмник сохраняет событие, подтверждает приём и передаёт обработку в очередь; уникальный ключ защищает бизнес-операцию от повтора. Если события связаны порядком, фиксируем правила для опоздавшего или пропущенного состояния.

Временная ошибка
Задача повторяется с ограничением частоты и числа попыток.
Некорректные данные
Событие уходит на разбор, сохраняя исходную нагрузку и причину отказа.
Неизвестный итог
Сверяемся с источником, прежде чем повторно создавать заказ, платёж или изменение доступа.

Панель диагностики позволяет найти цепочку по идентификатору события и безопасно повторить выбранную обработку.

Очередь необработанных событий должна быть видна ответственному. Для ручного повтора сохраняем причину и сотрудника, а сам повтор проходит те же проверки идемпотентности. Срок хранения исходного сообщения выбираем с учётом чувствительных данных и периода возможной сверки. Секрет подписи и персональные сведения не включаем в открытые диагностические ответы.

Надёжная обработка webhook: очереди, повторы и сверка: для разных отказов нужны разные действия. Схема PORTcore — portcore.ru.
Для разных отказов нужны разные действия. Неизвестный итог сверяется с источником перед повтором. Исправление данных и временный отказ не смешиваются в одной бесконечной очереди.