Реализация 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.