API gateway что это

api gateway что это — это единая точка входа для запросов к нескольким сервисам или API. Он принимает запрос от клиента, маршрутизирует его к нужному сервису, может проверять авторизацию, ограничивать нагрузку и возвращать ответ в удобном виде.

Зачем нужен шлюз

В распределённой архитектуре клиенту неудобно обращаться к десяткам сервисов напрямую. Шлюз убирает эту сложность: внешний интерфейс остаётся простым, а внутренняя структура системы может меняться без поломки клиентов.

• Скрывает внутренние адреса и состав сервисов;
• Собирает ответы из нескольких источников;
• Выполняет проверку токена, ключа или сессии;
• Задаёт лимиты, чтобы один клиент не перегрузил систему;
• Может делать преобразование заголовков, путей и формата ответа.

Это полезно, когда есть мобильное приложение, веб-клиент и внешние партнёры, а логика доступа у них отличается. Вместо дублирования правил в каждом сервисе их можно сосредоточить в одном месте.

Как работает на практике

Типичный сценарий такой: клиент отправляет запрос в шлюз, шлюз проверяет, можно ли его пропустить, а затем пересылает его в нужный сервис. Если ответ нужен составной, шлюз может обратиться сразу к нескольким сервисам и объединить результат.

Например, страница профиля может запрашивать данные пользователя, список заказов и настройки. Без шлюза фронтенд делал бы несколько отдельных вызовов, а с ним получает один понятный endpoint. Именно так api gateway что это помогает снизить связность между клиентом и внутренними сервисами.

При этом шлюз не обязан «понимать» бизнес-логику глубоко. Его задача — маршрутизация, защита, преобразование и наблюдаемость, а не замена самих микросервисов.

Чем отличается от похожих решений

Иногда шлюз путают с балансировщиком, reverse proxy и сервис-мешем. Отличие в том, что шлюз ориентирован на API и клиентский трафик, а не только на распределение нагрузки.

• Балансировщик распределяет запросы между экземплярами сервиса.
• Reverse proxy принимает трафик и пересылает его дальше, часто без понимания API-уровня.
• API Gateway дополнительно управляет доступом, агрегацией и преобразованием запросов.

Если нужен только простой перенос трафика, отдельный шлюз может быть лишним. Если же есть много клиентов, разный доступ и несколько сервисов, его применение обычно оправдано.

Когда он полезен и какие есть ограничения

Шлюз особенно уместен, когда:

• Нужно единое место для аутентификации и авторизации;
• Есть версии API и требуется мягко переводить клиентов на новые пути;
• Важны лимиты запросов, кэширование и журналирование;
• Нужно скрыть внутреннюю топологию системы.

Но есть и минусы. Шлюз становится дополнительным компонентом, который надо поддерживать, масштабировать и мониторить. Если настроить его слишком сложно, он превращается в узкое место и источник ошибок. Поэтому важно не переносить в него всю бизнес-логику и не делать из него «монолит перед микросервисами».

Проверить, что шлюз работает правильно, можно так: отправить запрос на известный endpoint, убедиться, что он доходит до нужного сервиса, затем проверить отказ по неавторизованному запросу, ограничение по частоте и корректность ответа при сбое одного из внутренних сервисов. Если поведение предсказуемо, а клиент видит стабильный интерфейс, задача решена. Когда вы понимаете, api gateway что это, легче выбрать между простым proxy и полноценной точкой управления API.