ym88659208ym87991671
Блок HTTP-запрос для чат-ботов | Документация для разработчиков

Работаем с HTTP-запросами

Обновлено 26 декабря 2023

Блок 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.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.