Блок HTTP-запрос предназначен для взаимодействия с внешними ресурсами с помощью http-запросов и сохранения ответов в переменных. Блок предлагает два перехода: для успешных и неуспешных запросов.
С помощью блока можно делать запросы со следующими http-методами:
- GET;
- PUT;
- POST;
- DELETE.
Адрес запроса может содержать переменные. Переменные в адресе необходимо указывать в фигурных скобках:
https://example/services/api?var=${variable}
Все фигурные скобки в адресе, которые не относятся к переменным, необходимо заменять на набор символов %7B
и %7D
для левой и правой скобки соответственно.
Тело (вкладка Body) и заголовки (вкладка Headers) запроса также могут содержать переменные.
Пример переменной в теле запроса:
{
"age": $age,
"name": "$Name"
}
Пример переменной в заголовке запроса:
Authorization: Token $Password
Для передачи токенов в заголовках и параметрах запроса вы можете использовать переменные созданные при добавлении собственных токенов.
Переключатель Использование сертификатов позволяет указать переменные, которые содержат сертификат и ключ, необходимые для аутентификации http-запроса. Сертификат и ключ добавляются в разделе Токены.
Тело запроса может содержать данные в любом формате: JSON, XML, произвольный текст.
Ответ стороннего сервиса, представленный в формате XML или в виде валидного JSON-объекта, автоматически преобразуется в объект JavaScript. Ответ сохраняется в системной переменной $httpResponse
. К полям таких ответов можно получить доступ с помощью точки:
$httpResponse.fieldName
Ответы, представленные в других форматах, сохраняются в $httpResponse
в виде необработанной строки.
Код ответа сохраняется в системной переменной $httpStatus
.