Расширение x-yc-apigateway-integration:http
Статья создана
Расширение x-yc-apigateway-integration:http перенаправляет запрос в указанный URL.
Поддерживаемые параметры
В таблице ниже перечислены параметры, специфичные для API-шлюза сервиса API Gateway. Описание остальных параметров читайте в спецификации OpenAPI 3.0.
| Параметр | Тип | Описание |
|---|---|---|
url |
string |
URL, по которому необходимо перенаправить вызов (должен быть доступен из интернета). В url осуществляется подстановка параметров. |
method |
enum |
Необязательный параметр. HTTP-метод, используемый для вызова. Если параметр не указан, используется метод запроса к API Gateway. |
headers |
map[string]string |
HTTP-заголовки, которые будут переданы. Заголовки исходного запроса не передаются. В headers осуществляется подстановка параметров. |
timeouts |
object |
Необязательный параметр. read и connect таймауты для выполнения вызова, в секундах. |
Спецификация расширения
Пример спецификации:
x-yc-apigateway-integration:
type: http
url: https://example.com/backend1
method: POST
headers:
Authorization: Basic ZjTqBB3f$IF9gdYAGlMrs2fuINjHsz
timeouts:
connect: 0.5
read: 5
Особенности расширения:
- По умолчанию заголовки, кроме
User-Agent, и параметры исходного запроса не передаются. Их необходимо указать в спецификации. ЗаголовокUser-Agentпередается, если не переопределен в спецификации.