Serverless API-шлюз

HTTP endpoints и webhooks на шлюзе: path parameters, режимы auth, rate limits и при необходимости custom domains — всё сходится на ваших serverless functions.

Serverless API-шлюз экспонирует ваши функции как HTTP-эндпоинты. Запросы к /gw/{tenant}/your-path маршрутизируются к вашим функциям.

Как работает маршрутизация API gateway

Раздел Gateway в сайдбаре — маршруты, методы, авторизация и шаблоны. API рабочего пространства по умолчанию: /gw/<slug-арендатора>/…, где slug — идентификатор вашего воркспейса. Именованные HTTP API (у каждого свой метка хоста субдомена) открываются как /gw/<метка>/…, чтобы в одном воркспейсе было несколько API.

В установках с поддержкой своих доменов можно привязать имя к именованному HTTP API, чтобы публичный трафик не шёл только через префикс /gw/….

Конфигурация маршрутов API gateway

Path parameters — /users/:id матчит /users/42.
Wildcards — /site/** матчит любой вложенный путь.
Методы — GET, POST, PUT, PATCH, DELETE или ANY.
Авторизация — Public, API Key или Bearer Token для каждого маршрута.

Формат события

Выберите Simple (плоские поля верхнего уровня) или совместимый с AWS API Gateway v2 формат:

event

// Your Lambda receives an event like (simple gateway format; body is always a string or null):
{
  "httpMethod": "POST",
  "path": "/api/users",
  "headers": {
    "content-type": "application/json"
  },
  "queryStringParameters": {
    "page": "1"
  },
  "pathParameters": {
    "id": "123"
  },
  "body": "{\"name\":\"Alice\"}"
}

Трансформация ответов

В расширенных настройках можно задать:

Response Headers — статические заголовки для каждого ответа.
Request Template — трансформация события перед отправкой в функцию.
Response Template — трансформация ответа функции перед отправкой клиенту.
Rate Limit — лимит запросов в минуту на маршрут.