HTTP-запрос

HTTP-запрос делает один HTTPS-вызов к API вне Slen и кладёт ответ в выполнение. Узел заморожен, если сервис не настроен иначе: палитра его не предлагает, а новая версия не может его содержать. Версия, опубликованная с ним, продолжает работать, и эта страница говорит, что узел в ней делает.

Что делает узел

Узел собирает один запрос из своих настроек и значений выполнения, делает вызов и читает ответ. Ответ со статусом 2xx выходит через По умолчанию. Всё остальное выходит через Ошибка: другой статус, включая перенаправление, — узел по нему не переходит; запрос, который узел не смог собрать; адрес, который сервис отклоняет; хост, до которого узел не достучался; ответ длиннее, чем узлу можно прочитать.

• Адрес всегда https на порту 443, а его хост — имя из списка разрешённых хостов сервиса: сам этот хост или его поддомен. Список один на весь сервис, и задаёт его тот, кто запускает сервис. С пустым списком узел ничего не вызывает.

• Перед каждым вызовом узел снова сверяет хост со списком и отклоняет хост, имя которого ведёт к непубличному адресу. Вызов не идёт через прокси.

• Узел тратит время, а не деньги: он ничего не резервирует и ничего не списывает.

Когда использовать

Новая версия не может содержать этот узел, поэтому вы встречаете его в версии, опубликованной до того, как узел заморозили. Черновик, в котором он остался, не публикуется, пока узел не убран, — как читать эту проверку, говорит статья Публикация, версии и откат.

Чтобы передать в запрос данные другого API, вызовите этот API из своего приложения и отправьте его ответ во входе или в контексте запроса — Отправить запрос.

Настройки

• Подстановка — это путь в двойных фигурных скобках, например {{input.customer_id}}: подстановки могут стоять в пути адреса и в его строке запроса, но не в хосте. Узел заполняет каждую значением по пути, закодированным для адреса. Число пишется как есть, а true и false — словами. Подстановка не заполняется, если путь ничего не нашёл или нашёл null, список или объект: тогда узел не делает вызова и выходит через Ошибка.

• Путь в nodes называет узел, который выполняется раньше этого.

• Узел просит JSON. С телом он отправляет Content-Type: application/json.

• Заголовок с учётными данными — авторизацией, cookie, API-ключом — отклоняется: флоу хранится как обычный JSON, и такой заголовок держал бы секрет открытым текстом.

• Если сервис не настроен иначе, узел ждёт ответа 5 секунд, но не дольше 15, и читает из него 65 536 байт, но не больше 262 144. Само соединение должно установиться за 3 секунды.

Порты

У узла два порта. По умолчанию обязателен: флоу, в котором он никуда не ведёт, не публикуется. Ошибка необязателен. Если он никуда не ведёт, а вызов не удался, выполнение заканчивается статусом failed с кодом http_request_failed.

Выход

Выход — это ответ: его статус, его тело, если тело — объект или список JSON, и его текст в остальных случаях.

{ "status": 200, "body": { "tier": "pro" }, "text": null, "error_code": null }

Вызов, который не получил ответа, оставляет status пустым и говорит причину в error_code:

{ "status": null, "body": null, "text": null, "error_code": "host_not_allowed" }

Следующий узел читает ответ как nodes.<key>.output.body — здесь nodes.call.output.body.tier, если ключ узла — call. Вернуть ответ с источником Выход узла отвечает всем выходом.

Ошибки

На каждый вызов узел пишет в трассировку одно событие http_called. Событие называет метод, хост, путь в том виде, как его написал автор, — с незаполненными подстановками, — статус, время и размер ответа. Чем была заполнена подстановка, строка запроса и заголовки не пишутся. Вызов, который не дал ответа, несёт reason.

[
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/customers/{{input.customer_id}}", "status": 404, "duration_ms": 182, "bytes": 61, "reason": null } },
  { "type": "http_called", "node_key": "call", "payload": { "method": null, "reason": "url_placeholder_unresolved" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": null, "reason": "body_unresolved" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": null, "reason": "url_unparseable" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": null, "duration_ms": 0, "bytes": 0, "reason": "egress_not_configured" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": null, "duration_ms": 0, "bytes": 0, "reason": "host_not_allowed" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "203.0.113.7", "path": "/v1/plans", "status": null, "duration_ms": 0, "bytes": 0, "reason": "host_is_address_literal" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": null, "duration_ms": 12, "bytes": 0, "reason": "host_unresolvable" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": null, "duration_ms": 9, "bytes": 0, "reason": "address_not_public" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": null, "duration_ms": 5004, "bytes": 0, "reason": "unreachable" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": 200, "duration_ms": 1310, "bytes": 2048, "reason": "request_failed" } },
  { "type": "http_called", "node_key": "call", "payload": { "method": "GET", "host": "api.example.com", "path": "/v1/plans", "status": 200, "duration_ms": 240, "bytes": 65537, "reason": "response_too_large" } }
]

У ответа со статусом вне 2xx нет reason: что произошло, говорит статус.

Черновик, в котором есть этот узел, отклоняется с кодом node_type_frozen — Проверки при публикации. Настройки узла тоже проверяются, при проверке флоу и при его публикации:

Пример

Узел вызывает адрес из своих настроек с клиентом запроса в пути. Вернуть ответ отвечает выходом узла. Если вызов не удался, выполнение идёт в Отклонить запрос и заканчивается статусом rejected с кодом, на который настроен этот узел.

См. также

• Контекст выполнения и пути — что могут читать подстановка и путь тела.

• Порты и ветвление — что делает порт, который никуда не ведёт.

• Как устроен флоу — все узлы конструктора.