HTTP-запрос

Untitled

Описание узла

HTTP Request — узел типа «действие», используемый для отправки запросов к API внешнего приложения.

Этот узел поддерживает отправку запросов по протоколам HTTP и HTTPS.

Настройка узла

Для настройки узла HTTP Request необходимо заполнить обязательные и опциональные поля.

Обязательные поля:

URL;
Method.

URL

В поле URL вводится адрес API внешнего приложения, к которому нужно отправить запрос.

Переменные и параметры из других узлов можно вставлять в URL с помощью символа «?»

Method

Поле используется для указания метода запроса (GET/POST/PUT/PATCH/DELETE).

Proxy

Блок настройки прокси включает поля:

Enter proxy address: поле для ввода адреса прокси-сервера, через который должен направляться запрос.
Enter login: поле для ввода учётных данных прокси.
Enter password: поле для ввода пароля прокси.

Эти поля заполняются, когда доступ к API внешнего приложения ограничен локальной сетью.

Body

Блок полей для настройки и заполнения тела запроса:

Перед заполнением поля необходимо выбрать формат передачи тела запроса (подробнее можно прочитать здесь):

raw;
form-data;
x-www-form-urlencoded.

При выборе form-data и x-www-form-urlencoded доступны:

Кнопка Add a param (1) для добавления новой пары Key-Value;
Кнопка Delete (2) для удаления пары Key-Value.

Headers

Блок полей для заполнения заголовков запроса:

Key — поле для ввода дополнительной информации о запросе. Например, формат — content-type;
Value — поле для ввода значения дополнительной информации о запросе. Например, значение формата — application/json.

Для добавления новой пары Key-Value используйте кнопку Add a header (1). Для удаления пары Key-Value используйте кнопку Delete (2).

При авторизации через Bearer-токен одним из заголовков запроса должна быть пара с Key Authorization и Value Bearer <token>.

Authorization

Блок полей для выбора метода аутентификации и ввода учётных данных.

Доступны следующие методы аутентификации:

Without authentication — для запросов, не требующих аутентификации, или требующих аутентификации через Bearer-токен;
Basic auth — для запросов, требующих базовой аутентификации;
Digest auth — для запросов, требующих дайджест-аутентификации;
NTLM auth — для запросов, требующих NTLM-аутентификации.

При выборе методов Basic auth/Digest auth необходимо ввести учётные данные: имя пользователя и пароль. При выборе метода NTLM auth необходимо ввести имя пользователя, пароль и домен.

Скрытие данных в истории

Переключатель для скрытия данных.

Дополнительную логику скрытия данных можно настроить в поле, которое появляется при нажатии кнопки Advanced Settings.

Быстрая настройка узла

Приложения, предоставляющие API, могут указывать примеры HTTP-запросов в формате CURL. Например:

curl -X GET https://api.test.com/v1/email/balance \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer $API_TOKEN'

Для быстрой настройки узла HTTP Request выполните следующие шаги:

Нажмите на Create from Example (CURL).

Скопируйте пример запроса и вставьте его в модальное окно. Затем нажмите кнопку Create:

Untitled 1.png

Проверьте заполненные поля узла HTTP Request.

Untitled 2.png

На этой странице