Перенос webhook на новый обработчик
Версия 2.7
Подготовка нового адреса
Проверьте, что новый обработчик доступен по настроенному URL, читает исходное тело запроса и использует соответствующий секрет среды. Подготовьте запись в надёжную очередь, журнал кодов ответа и метрику возраста внутренней задачи. Если меняется только маршрут входящего запроса, сохраните прежнее сопоставление номера отправления и локального заказа.
Контроль в тестовой среде
Сначала прогоните демонстрационное отправление и тестовый webhook. Убедитесь, что проверка подписи проходит, событие сохранилось, а обработчик ответил 2xx после записи. Передайте то же событие повторно и проверьте дедупликацию. Если путь включает новый прокси, проверяйте подпись на реальном тестовом маршруте, потому что middleware может менять сериализацию запроса.
Как избежать двойной обработки при переносе
Если во время переноса старый и новый обработчики способны принять один и тот же event_id, используйте общий реестр приёма или разберите расхождения перед запуском второй очереди. Самый простой способ подтвердить результат — сопоставить одинаковый event_id в журналах двух входов и проверить один бизнес-эффект. Если хранилища разделены, зафиксируйте период, за который дежурный должен провести сверку.
Контроль после переключения
Откройте журнал доставок в настройках интеграции. Сравните настроенный URL, время и ответ обработчика. Затем проверьте запись в новой очереди и обновление локальной карточки. Ошибка на одном из этих шагов требует отдельного расследования: успешная HTTP-доставка и успешное изменение заказа подтверждаются разными журналами. Сохраните время переключения и event_id контрольного события.
Возврат на прежний маршрут
Если перенос вызывает пропуски или рост ошибок, остановите дальнейшее изменение конфигурации и восстановите последний проверенный адрес по процедуре вашей команды. Проверьте доступность прежней очереди, затем сопоставьте события, которые могли попасть на оба адреса. При отсутствии события в журнале приложения проверьте историю отправления и записи доставки прежде, чем формировать новую бизнес-операцию.
Подготовка окна наблюдения
Назначьте дежурного, который видит доставку на обоих маршрутах. До начала переноса запишите количество успешных и ошибочных запросов за обычный период. После переключения проверьте частоту ошибок, задержку применения и возраст старых заданий. Если новый маршрут работает, сверка старой очереди покажет, когда прежний обработчик можно убрать из рабочего процесса.
Как завершить перенос
Отметьте конечный URL и идентификаторы контрольных событий. Зафиксируйте, как обработаны задания, поступившие до переключения. Если остались события с неизвестным исходом, сохраните список для дежурного и причину. Удаление старых настроек выполняйте после проверки маршрута и завершения необходимой сверки с журналами.