HTTP Запрос (HTTP Request node)

HTTP запрос позволяет получать данные из любого приложения с помощью REST API. Ноду HTTP запроса можно использовать, как обычный инструмент или в качестве инструмента ИИ агента.

Существует 2 способа создать HTTP запрос ноду:

• Через настройку параметров
• Через импорт curl запроса

Параметры ноды

Метод запроса

• DELETE
• GET
• HEAD
• OPTIONS
• PATCH
• POST
• PUT

URL

Ссылка запроса

Аутентификация (Authentication)

Параметры отправки запроса (Query Parameters)

Параметры запроса работают как фильтры HTTP запросов. Можно выбрать из 2-х вариантов:

• Поля (Using Fields Below) — Ключ / Значение параметров. Чтобы добавить пару, нужно нажать Add Parametr
• JSON (Using JSON) — Для определения параметров запроса с помощью JSON

Заголовки (Send Headers)

Заголовки содержат метаданные или контекст запроса

Тело запроса (Send Body)

Нужно выбрать тип содержимого (Body Content Type), которое соответсвует нужному формату.

• Form URLencoded — использовать это, чтобы отправить запрос, как application/x-www-form-urlencoded
• Using Fields Below — для пары имя / значение
• Using Single Field — для записи параметров в одну строку fieldname1=value1&fieldname2=value2
• Form-Data — для того, чтобы отправить текст вместе с файлом как multipart/form-data

JSON

Отправить тело в формате JSON

Файл n8n (n8n Binary File)

Для отправки файла, сохраненного в n8n в теле запроса

RAW

Для отправки необработанных данных в теле запроса

Параметры ноды (Node options)

Array Format in Query Parameters

Сериализация массива в querry строке без скобок (foo=a&foo=b), со скобками (foo[]=a&foo[]=b) или со скобками и индексами (foo[0]=a)

Batching

Разбивает большой поток входных items на пакеты

• Items per Batch — сколько отправлять за раз;
• Batch Interval — пауза между пакетами (мс).

Ignore SSL Issues

Если у сервера проблемы с сертификатом, но всё равно надо получить ответ — включить. По умолчанию узел скачивает ответ только при валидном SSL.

Lowercase Headers

Делать имена заголовков строчными (вкл по умолчанию) или оставить как есть.

Redirects

Следовать 3xx-редиректам (вкл по умолчанию) и, если да, то сколько раз максимум

Response

Управление тем, что именно положить на выход узла:

• Include Response Headers and Status — вернуть не только тело, но и заголовки + статус код.
• Never Error — не падает при ошибке
• Response Format — как интерпретировать ответ:
  • Autodetect (по содержимому),
  • File (положить файл в указанное поле — Put Output in Field),
  • JSON,
  • Text (в указанное поле)

Pagination

Когда результат приходит порциями (страницами):

• Pagination Mode:
  • Off — выкл,
  • Update a Parameter in Each Request — сами меняете page/offset/limit,
  • Response Contains Next URL — API само даёт ссылку на следующую страницу.
    В помощь есть переменные $pageCount, $request, $response.

Proxy

Указать HTTP-прокси для этого запроса (перебивает глобальные HTTP_PROXY/HTTPS_PROXY/ALL_PROXY).

Timeout

Сколько миллисекунд ждать начала ответа (заголовков). Если не пришло — запрос отменяется.

Импорт cURL

Кнопка Import cURL: можно вставить готовую cURL-команду из доков API — нода сама заполнит поля.