HTTP-запрос

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

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

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

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

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

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

• URL;
• Method.

URL

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

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).

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 выполните следующие шаги:

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

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

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