Перейти к основному содержимому

04.4.5 HTTP Request

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

HTTP Request - узел типа действие, необходимый для отправки запросов к API внешнего приложения.

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

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

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

К обязательным* относятся поля:

  • URL;
  • Метод.

URL​

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

подсказка

Переменные и параметры из других узлов могут подставляться в URL-адрес через символ “?”

Метод​

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

Proxy​

Блок настройки с полями:

  • Введите адрес proxy - поле для ввода адреса proxy, через который необходимо передать запрос;
  • Введите логин - поле для ввода учетных данных для использования proxy;
  • Введите пароль - поле для ввода учетных данных для использования proxy.

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

Тело​

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

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

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

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

  • кнопка Добавить параметр (1) - для добавления новой пары Ключ-Значение;
  • кнопка Удалить (2) - для удаления пары Ключ-Значение.

Заголовки​

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

  • Ключ - поле для ввода типа дополнительной информации по запросу. Например, формата - content-type;
  • Значение - поле для ввода значения дополнительной информации по запросу. Например, значения формата - application/json.

Для добавления новой пары Ключ-Значение доступна кнопка Добавить заголовок (1). Для удаления пары Ключ-Значение доступна кнопка Удалить (2).

подсказка

В случае авторизации через Bearer-токен одним из заголовков запроса является пара ключ Authorization и значение Bearer <токен>.

Авторизация​

Блок полей для выбора способа авторизации и заполнения учетных данных для авторизации. К выбору доступны следующие способы авторизации:

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

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

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

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

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

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

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

Например, API MailPost для получения информации о балансе:

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

  1. Нажать на Создать из примера (CURL);
  1. Скопировать пример запроса и вставить его в модальное окно. Нажать на кнопку Создать:
  1. Просмотреть наличие заполненных полей узла HTTP Request.