HTTP-запрос

Модуль HTTP-запросы

Шаг HTTP-запрос позволяет отправлять произвольные HTTP-запросы на сервера пользователя. Это позволяет интегрировать Smartbot с вашим сайтом, CRM или интернет-магазином.

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

Обратите внимание, что для того, чтобы отправлять запросы на какой-либо сайт, нужно подтвердить, что вы являетесь его владельцем.

Если вы интегрируетесь с существующим сервисом, то всю необходимую информацию для настройки этого шага вы можете найти в официальной документации к API этого сервиса, либо свяжитесь с разработчиками вашего сайта.

Краткая справка по полям шага:

  • Тип запроса: GET/POST/...

  • URL-адрес: страница (endpoint), к которой должен обратиться Smartbot, тут же можно указать query-параметры запроса, например: https://some.site/some_endpoint?key1=value1&key2=value2

  • Тело запроса: полезная нагрузка, может быть задана в трёх разных форматах:

    • Форма: тело запроса представляет собой форму (список пар ключ-значение), запрос будет отправляться с заголовком Content-Type: application/x-www-form-urlencoded (если явно не задано другое значение этого заголовка)

    • JSON: тело запроса является JSON-документом. Запрос будет отправляться с заголовком

      Content-Type: application/json(если явно не задано другое значение этого заголовка)

    • Текст: данные отправляются as-is, никаких дополнительных заголовков не добавляется

  • Заголовки: дополнительная информация, например, авторизационные данные: Authorization: Bearer [token]

Ниже, после настройки параметров запроса, задаются переменные, в которые будет сохранён ответ сервера:

  • Тело ответа: данные, которые прислал сервер в ответ. Если Content-Type равенapplication/json, то типом этой переменной будет Словарь, иначе Строка

  • Статус ответа: число, например 200, 400 или 500 вы можете проверять статус ответа, чтобы узнать завершился ли запрос успешно

  • Заголовки ответа: сервер также может прислать какую-то дополнительную информацию в виде заголовков, они сохранятся в переменную типа Словарь

По умолчанию все эти данные сохраняются во временные переменные: %body%, %status% и %headers% соответственно.

Пример использования этого шага можно посмотреть тут: Пример использования.

Last updated