Реализация API Gateway Pattern для микросервисов

Реализация 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 лучше подходит для сложных сценариев с кастомными плагинами, 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 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 

Процесс работ по внедрению

Стоимость рассчитывается индивидуально после аудита вашей архитектуры. Закажите консультацию — оценим проект бесплатно.

Состав реализации API Gateway

• Проектирование маршрутов и политик безопасности
• Настройка Kong, Traefik или облачного шлюза под вашу инфраструктуру
• Интеграция с JWT/OAuth2, LDAP или другим провайдером
• Конфигурация rate limiting, circuit breaker и мониторинга
• Документация API и инструкции для команды
• Передача доступов и обучение ваших инженеров

Мы также оказываем поддержку после внедрения: обновление версий, оптимизация производительности. Наши инженеры имеют сертификаты по Kubernetes и Kong, более 7 лет опыта и 50+ успешных проектов. Мы гарантируем стабильную работу шлюза под нагрузкой. Получите консультацию для вашего проекта.

Дополнительные материалы

Подробнее о паттерне можно прочитать в Wikipedia. Официальная документация Kong доступна на konghq.com.