Реализация API Gateway Pattern для микросервисов
Представьте: у вас 15 микросервисов, каждый со своим API. Фронтенд делает десятки запросов к разным эндпоинтам, а аутентификация дублируется в каждом сервисе. Один неудачный рефакторинг — и клиенты ловят 500-е ошибки. API Gateway решает эту боль: единая точка входа, централизованная маршрутизация, аутентификация и rate limiting. Вместо прямых вызовов к десяткам сервисов клиент общается с одним шлюзом, который маршрутизирует запросы, агрегирует данные и применяет политики безопасности.
Этот паттерн упрощает безопасность, снижает нагрузку на сервисы и делает систему масштабируемой. Наши инженеры с 7+ летним опытом в микросервисах внедряют API Gateway под ключ — от выбора инструмента до настройки мониторинга. Свяжитесь с нами для консультации по вашему проекту.
Технические проблемы микросервисной архитектуры
Отметим: когда клиент запрашивает данные с разных сервисов, возникает проблема множественных вызовов. Например, страница профиля требует данные пользователя, его заказов и уведомлений. Без шлюза клиент делает 3 запроса. С API Gateway — один. Шлюз параллельно собирает данные через Promise.allSettled и возвращает единый ответ. Это снижает задержки на 40% и упрощает клиентскую логику.
Ещё одна проблема — дублирование аутентификации. Каждый микросервис вынужден проверять JWT, что увеличивает latency и риск ошибок. API Gateway проверяет токен один раз и передаёт данные пользователя в заголовках. Это уменьшает нагрузку на сервисы и централизует безопасность.
Как API Gateway решает проблему N+1 запросов?
Агрегация запросов (BFF-паттерн в шлюзе)
Мобильный клиент за один запрос получает данные из нескольких сервисов. Шлюз параллельно обращается к ним и собирает ответ в единый JSON. Пример реализации на Express:
// Gateway aggregates data from multiple services
app.get('/api/dashboard/:userId', jwtMiddleware, async (req, res) => {
const { userId } = req.params;
const [user, orders, notifications] = await Promise.allSettled([
userService.get(`/users/${userId}`),
orderService.get(`/orders?customerId=${userId}&limit=5`),
notificationService.get(`/notifications/${userId}/unread`)
]);
res.json({
user: user.status === 'fulfilled' ? user.value.data : null,
recentOrders: orders.status === 'fulfilled' ? orders.value.data : [],
unreadCount: notifications.status === 'fulfilled'
? notifications.value.data.count : 0
});
});
Какие метрики улучшает API Gateway?
Время отклика (TTFB) уменьшается за счёт агрегации, количество сетевых запросов сокращается в 3-5 раз. Core Web Vitals (LCP, CLS) улучшаются, так как клиент получает все данные одним ответом. Шлюз также снижает нагрузку на микросервисы — они обрабатывают только проверенные запросы.
Как мы внедряем API Gateway
Функции, которые настраиваем
- Маршрутизация —
/api/orders→ Order Service,/api/users→ User Service - Аутентификация и авторизация — JWT/OAuth2 проверяется один раз в шлюзе
- Rate Limiting — защита от злоупотреблений
- SSL Termination — TLS завершается на шлюзе, микросервисы общаются по HTTP внутри кластера
- Request/Response трансформация — изменение форматов, добавление заголовков
- Агрегация запросов — один запрос клиента → несколько запросов к сервисам
- Circuit Breaker — защита от каскадных отказов
- Логирование и трейсинг — единая точка сбора access logs
Сравнение инструментов
| Инструмент | Тип | Особенности |
|---|---|---|
| Kong | Self-hosted / Cloud | Плагины на Lua/Go, Kubernetes Ingress |
| Traefik | Self-hosted | Автодискавери в Docker/K8s |
| AWS API Gateway | Managed | Интеграция с Lambda, IAM |
| NGINX + Lua | Self-hosted | Максимальный контроль |
| Envoy | Proxy | gRPC, сложные сценарии |
| Express Gateway | Node.js | Простые случаи |
Kong лучше подходит для сложных сценариев с кастомными плагинами, Traefik выигрывает в интеграции с Kubernetes. Мы выбираем инструмент под ваш стек. Наш опыт включает проекты с Kong (более 50 сервисов) и Traefik (K8s-кластеры до 30 нод).
Конфигурация Kong
Kong — самый популярный self-hosted шлюз:
# kong.yaml (декларативная конфигурация)
_format_version: "3.0"
services:
- name: order-service
url: http://order-service:3000
routes:
- name: orders-route
paths: ["/api/orders"]
methods: ["GET", "POST", "PUT", "DELETE"]
- name: user-service
url: http://user-service:3001
routes:
- name: users-route
paths: ["/api/users"]
methods: ["GET", "PUT"]
plugins:
- name: jwt
config:
claims_to_verify: ["exp"]
- name: rate-limiting
config:
minute: 100
hour: 5000
policy: local
- name: request-transformer
config:
add:
headers: ["X-Service-Version:1.0"]
Аутентификация на уровне шлюза
JWT верифицируется в шлюзе, микросервисы получают уже проверенный заголовок с данными пользователя:
// Кастомный middleware на Express Gateway
async function jwtMiddleware(req, res, next) {
const token = req.headers.authorization?.replace('Bearer ', '');
if (!token) return res.status(401).json({ error: 'No token' });
try {
const payload = jwt.verify(token, process.env.JWT_SECRET);
// Прокидываем данные пользователя в заголовках
req.headers['X-User-Id'] = payload.sub;
req.headers['X-User-Role'] = payload.role;
req.headers['X-User-Email'] = payload.email;
next();
} catch {
res.status(401).json({ error: 'Invalid token' });
}
}
Пример конфигурации Traefik в Kubernetes
# Traefik IngressRoute
apiVersion: traefik.containo.us/v1alpha1
kind: IngressRoute
metadata:
name: api-gateway
spec:
entryPoints:
- websecure
routes:
- match: PathPrefix(`/api/orders`)
kind: Rule
services:
- name: order-service
port: 3000
middlewares:
- name: jwt-auth
- name: rate-limit
- match: PathPrefix(`/api/users`)
kind: Rule
services:
- name: user-service
port: 3001
middlewares:
- name: jwt-auth
---
apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
name: rate-limit
spec:
rateLimit:
average: 100
burst: 50
period: 1m
Процесс работ по внедрению
| Этап | Длительность | Результат |
|---|---|---|
| Аудит архитектуры | 1-2 дня | Схема маршрутов, требования к безопасности |
| Настройка базового шлюза | 3-5 дней | Рабочая маршрутизация, JWT-аутентификация |
| Расширенная конфигурация | 2-3 дня | Rate limiting, circuit breaker, логирование |
| Кастомная агрегация | 1-2 недели | BFF-эндпоинты, оптимизация запросов |
Стоимость рассчитывается индивидуально после аудита вашей архитектуры. Закажите консультацию — оценим проект бесплатно.
Состав реализации API Gateway
- Проектирование маршрутов и политик безопасности
- Настройка Kong, Traefik или облачного шлюза под вашу инфраструктуру
- Интеграция с JWT/OAuth2, LDAP или другим провайдером
- Конфигурация rate limiting, circuit breaker и мониторинга
- Документация API и инструкции для команды
- Передача доступов и обучение ваших инженеров
Мы также оказываем поддержку после внедрения: обновление версий, оптимизация производительности. Наши инженеры имеют сертификаты по Kubernetes и Kong, более 7 лет опыта и 50+ успешных проектов. Мы гарантируем стабильную работу шлюза под нагрузкой. Получите консультацию для вашего проекта.
Дополнительные материалы
Подробнее о паттерне можно прочитать в Wikipedia. Официальная документация Kong доступна на konghq.com.