Обновления протоколов и API ломают не трафик, а слабую обвязку вокруг него

Платформы редко меняют логику «в лоб». Чаще они сдвигают формат событий, порядок обязательных полей, схему подписи запросов, таймауты и правила ретраев. Внешне это выглядит как мелкая правка, а на практике — как массовый разъезд статусов, дубль-ивенты и пустые конверсии в витрине.

Разбирать такие изменения нужно по слоям:
— транспорт: заголовки, TLS, лимиты, keep-alive;
— контракт: обязательные поля, типы, кодировки, версия схемы;
— семантика: когда событие считается валидным, чем отличается pending от failed;
— антифрод: новые пороги, задержки, дополнительные проверки.

Статистика показывает следующее. Самые дорогие инциденты возникают не там, где API «не отвечает», а там, где интеграция отвечает слишком уверенно. Система продолжает принимать старый формат, молча заполняет пропуски дефолтами и потом неделями кормит аналитику мусором. Такой баг любят все: и площадка, и команда, которая его не заметила.

Поэтому базовый регламент простой: держать контракт в тестах, логировать сырой запрос и ответ, сравнивать схемы на входе и выходе, а для критичных потоков — иметь фолбэк на старый маршрут. Развертывание прошло в штатном режиме только тогда, когда метрики совпали с реальным поведением, а не с ожиданиями разработчика.

Оптимизируем пороговые значения, но сначала убеждаемся, что платформа вообще получает те данные, которые мы думаем, что отправляем.