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

Шлюз полезен, когда внешним системам приходится знать адреса и особенности нескольких ваших сервисов. Он даёт стабильный вход, но не должен превращаться в скрытый монолит бизнес-логики.
Что выносим на границу
Аутентификацию, квоты, версионирование, маршрутизацию и корреляционный идентификатор. Согласуем формат ошибок и правила совместимости при обновлении внутренних сервисов.
Граница между внешними клиентами и внутренними сервисами
Шлюз удобен, когда партнёры должны обращаться к устойчивому контракту, а внутреннее устройство продукта меняется. На границе задаём аутентификацию, ограничения частоты, маршрутизацию и идентификатор запроса. Бизнес-логику оставляем в подходящих сервисах, иначе единая точка входа быстро становится ещё одной сложной системой.
Для разных партнёров могут понадобиться отдельные квоты и версии API. Продумываем отзыв ключа, переход на новый контракт и диагностику обращения без записи секретов в логи. Если внутренний сервис недоступен, клиент получает определённую ошибку и понятное правило повтора. В состав подключения входят примеры запросов и наблюдаемость: технической поддержке нужен способ проследить путь запроса по всем участникам.
Публичная ошибка должна сообщать достаточно для исправления запроса и не раскрывать внутренние адреса или ключи. Для разработчиков партнёра готовим примеры типовых отказов. Метрики шлюза отделяют лимиты, ошибки авторизации и недоступность сервиса: общее число ответов 500 не помогает выбрать владельца проблемы и восстановить работу.