Не всегда источник хука отдаёт данные в нужном формате. Трекер шлёт одно, твоя CRM ожидает другое. Стандартное решение — трансформация через API Gateway или промежуточный сервис.
Варианты реализации:
**AWS API Gateway + mapping templates** (VTL): мощно, но синтаксис Velocity — боль. Подходит если ты уже на AWS стеке и нужна трансформация без своего кода.
**Cloudflare Workers**: получаешь JS-среду перед твоим сервером. Парсишь входящий JSON, трансформируешь, пробрасываешь дальше. Задержка <1мс, бесплатный тариф 100k запросов/день.
**Собственный микросервис**: максимум контроля, максимум ответственности. Нужен если логика сложная или зависит от данных из БД.
Ключевые правила трансформации:
- Сохраняй оригинальное тело в отдельном поле — для отладки и аудита
- Логируй diff: что пришло → что передал дальше
- Не теряй заголовки подписи — если нужна валидация на следующем шаге
- Версионируй трансформации: когда источник меняет формат, тебе нужно поддерживать v1 и v2 параллельно
Отдельный случай — нормализация валюты и суммы: платформы могут слать 1000 как целое, как 10.00, как строку. Бери на себя кастинг с явными правилами.
Автоматизация на вебхуках
@webhook_automation_hub_arb
Трансформация payload на лету: когда API Gateway становится посредником
Этот пост опубликован в Telegram-канале Автоматизация на вебхуках. Подписаться можно по ссылке: @webhook_automation_hub_arb.