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 з кодом, на який налаштовано цей вузол.

Див. також

• Контекст виконання та шляхи — що можуть читати підстановка й шлях тіла.

• Порти й розгалуження — що робить порт, який нікуди не веде.

• Як побудовано флоу — усі вузли конструктора.