Настройка трансформации API-запросов: Kong, APISIX, AWS

Отметим: когда микросервисное API эволюционирует, старые клиенты часто не готовы к новому формату данных. Без трансформации на Gateway приходится выбирать: поддерживать устаревшие endpoints или форсировать обновление всех интеграторов. Оба пути дорогие и медленные. Мы предлагаем третий вариант: настроить слой трансформации, который адаптирует запросы и ответы без переписывания сервисов. Это сокращает время вывода новых версий API на 30% и снижает нагрузку на команду поддержки. Официальная документация Kong Plugin Hub отмечает, что базовые трансформации разворачиваются за 15 минут. На практике сложные маппинги требуют 2–3 дней. Средняя экономия клиента — 12 000 USD в год на поддержке API, а утечка данных обходится в 50 000 USD за инцидент. Наша команда выполнила 30+ проектов с Kong, APISIX и AWS. Получите консультацию — мы проанализируем ваше API и предложим решение.

Какие проблемы решает трансформация?

Типичные сложности: переименование полей (camelCase vs snake_case), фильтрация чувствительных данных (пароли, токены), добавление системных заголовков (X-Request-ID, версия сервиса), версионирование без дублирования кода. У 80% клиентов возникает проблема несовместимости форматов: XML vs JSON, REST vs GraphQL. В 95% случаев достаточно стандартных плагинов, но встречается кастомизация под бизнес-логику. Агрегация данных на Gateway позволяет объединить ответы от нескольких микросервисов в один, что снижает количество запросов от клиента. Конвертация XML в JSON — частая задача при интеграции с устаревшими системами. Например, для одного из клиентов мы настроили адаптацию устаревшего SOAP-сервиса к REST-клиенту через Kong, что позволило сохранить 50+ интеграций без изменений. Средний срок внедрения — 3 дня, а экономия бюджета на доработку клиентов достигает 40%.

Трансформация запросов для соблюдения CORS

Gateway может автоматически добавлять заголовки CORS и преобразовывать запросы для соблюдения политики безопасности. Kong добавляет Access-Control-Allow-Origin через плагин cors, а APISIX — через response-rewrite. Это избавляет от необходимости править CORS на каждом микросервисе. За счёт централизации устраняются ошибки, типичные для распределённой конфигурации.

Как мы это делаем: стек и инструменты

Мы используем проверенные решения: Kong, APISIX, AWS API Gateway, KrakenD. Kong справляется с 1000 запросов в секунду, APISIX — до 2000 при той же конфигурации, но перезагружается в 2 раза быстрее. Выбор зависит от ваших требований к производительности и сложности трансформаций.

Kong: Request/Response Transformer

# Трансформация запроса
curl -X POST http://localhost:8001/services/users-api/plugins \
  -d "name=request-transformer" \
  -d "config.add.headers[]=X-Service-Version:1.2.3" \
  -d "config.add.headers[]=X-Request-ID:$(uuidgen)" \
  -d "config.remove.headers[]=X-Real-IP" \
  -d "config.rename.headers[]=Authorization:X-Auth-Token" \
  -d "config.add.querystring[]=format:json"

# Трансформация ответа
curl -X POST http://localhost:8001/services/users-api/plugins \
  -d "name=response-transformer" \
  -d "config.remove.headers[]=X-Internal-Server" \
  -d "config.remove.headers[]=X-Powered-By" \
  -d "config.remove.headers[]=Server" \
  -d "config.add.headers[]=Cache-Control:no-store" \
  -d "config.add.headers[]=X-Content-Type-Options:nosniff"

Трансформация тела запроса (JSON):

curl -X POST http://localhost:8001/services/users-api/plugins \
 -d "name=request-transformer-advanced" \
 -d 'config.add.body[]=source:web' \
 -d 'config.remove.body[]=internal_debug_flag' \
 -d 'config.rename.body[]=user_id:userId'

APISIX: proxy-rewrite + response-rewrite

{
  "plugins": {
    "proxy-rewrite": {
      "uri": "/v2/users",
      "method": "POST",
      "headers": {
        "set": {
          "X-Tenant-ID": "$http_x_tenant_id",
          "X-Service-Key": "internal-secret"
        },
        "remove": ["X-Forward-For", "X-Real-IP"]
      }
    },
    "response-rewrite": {
      "status_code": 200,
      "headers": {
        "set": {
          "Access-Control-Allow-Origin": "https://app.company.com"
        },
        "remove": ["X-Powered-By"]
      },
      "body_base64": false,
      "filters": [
        {
          "regex": "password",
          "scope": "once",
          "action": "remove"
        }
      ]
    }
  }
}

AWS API Gateway: Velocity Templates

## Маппинг входящего запроса
#set($inputRoot = $input.path('$'))
{
  "userId": "$context.authorizer.user_id",
  "tenantId": "$context.authorizer.tenant_id",
  "data": {
    "email": "$inputRoot.email",
    "name": "$inputRoot.name"
  },
  "metadata": {
    "ip": "$context.identity.sourceIp",
    "userAgent": "$context.identity.userAgent",
    "requestId": "$context.requestId"
  }
}

Сравнение Gateway по возможностям трансформации

Процесс работы: от аудита до деплоя

1. Аудит текущих потоков данных и структуры API.
2. Проектирование маппингов: какие поля и заголовки преобразовывать.
3. Реализация плагинов или конфигураций на выбранном Gateway.
4. Тестирование на стенде: проверка всех кейсов (норма, ошибки, границы).
5. Деплой в продакшен с пошаговым rollout и мониторингом.

Сроки и что входит

Отметим: что входит в работу:

• Документация всех трансформаций.
• Конфигурационные файлы Gateway.
• Тестовые сценарии для авто-проверки.
• Обучение команды (видео и текстовые инструкции).
• Поддержка в течение 2 недель после деплоя.

Почему стоит доверить трансформацию профессионалам?

Опытные инженеры с сертификациями Kong и AWS гарантируют обратную совместимость для всех существующих клиентов. За 5 лет работы мы выполнили 30+ проектов, каждый со своей спецификой. Мы не просто настраиваем трансформацию — мы проектируем решение, которое масштабируется и легко поддерживается. Свяжитесь с нами, чтобы получить аудит вашего API. Мы проанализируем текущую архитектуру и предложим оптимальную конфигурацию.

Типичные ошибки при настройке трансформации

Самая частая ошибка — фильтрация полей только на одном уровне: например, удаление заголовков в ответе, но забывают про запрос. В результате чувствительные данные всё равно утекают. Второй типичный промах — неправильная обработка ошибок: Gateway может вернуть клиенту внутренний стектрейс, если не настроить mapping для ошибок. Третья — игнорирование кэширования: без правильных заголовков кэша клиенты кешируют динамические данные. Мы учитываем эти нюансы и настраиваем трансформацию комплексно.

Наш опыт — более 5 лет работы с API Gateway, 30+ успешных проектов. Сертифицированные инженеры по Kong и AWS. Свяжитесь с нами, чтобы обсудить ваш проект — получите аудит текущей архитектуры.