API Gateway приносит пользу, когда централизует действительно общие пограничные функции, но становится опасным узким местом, если в него постепенно переносят всю бизнес-логику распределенной системы.
Оставьте границу
Шлюз может проверять доступ, ограничивать частоту, маршрутизировать и собирать технические метрики. Доменные решения оставляйте сервисам.
Защитите доступность
Разверните несколько экземпляров, задайте таймауты, пределы тела и безопасное поведение при отказе зависимостей. Тестируйте перегрузку.
Управляйте изменениями
Версионируйте маршруты и политики как код, проверяйте совместимость клиентов и сохраняйте корреляционный идентификатор. Невидимая магия мешает расследованию.
Начните с небольшого набора общих политик и измерьте задержку, ошибки и удобство сопровождения, не превращая центральный шлюз в обязательный посредник для всех внутренних вызовов, которым он не добавляет полезного контроля.
Контракты проектируйте по правилам версионирования API. Технические логи связывайте единым сквозным идентификатором.
