Отправить запрос на внешний сайт

Действие позволяет отправить запрос на внешний сайт, например, по API. Например с помощью этого действия:

  • Развлечь пользователей в чате шуткой

  • Выдать мудрую мысль / гороскоп / анекдот в чате

  • Если вы технарь, то можете интегрировать Multy.AI через запросы прямо сейчас, не дожидаясь пока неободимых функционал будет добавлен. Например, необходимую платежную систему. Примеры таких интеграций вы можете увидеть в инструкциях:

Рассмотрим действие подробнее:

На самом деле тут все просто:

  • URL адрес - адрес на который необходимо отправлять запрос. Это может быть сайт с цитатами, шутками, гороскопом, прогнозом погоды или даже платежной системы. Для проверки корректности данных можете использовать сайт: https://httpbin.org/anything И отправлять запросы на него.

Метод отправки:

  • GET - данные будут отправлены методом GET. Т.е. как будто пользователь открыл страницу в браузере.

  • JSON POST - данные будут отправлены методом POST в виде JSON-объекта. Например, вы отправляете параметры: user=Vasya&age=28, то они будут переданы сайту в таком формате: {"user": "Vasya", "age": 28}

  • FORM POST - данные будут отправлены методом POST. Будто пользователь заполнил форму на вашем сайте. В большинстве случаев для отправки данных достаточно использовать FORM POST или JSON POST (если вам необходимо передавать данные в JSON).

  • PHP POST - данные будут отправлены методом POST. Моэнь быть использовано для совместимости со старыми сайтами, написанными на PHP.

  • PUT - данный метод позволяет частично изменять в запросе данные по API.

  • PATCH - данный метод позволяет редактировать в запросе данные по API.

  • DELETE - данный метод позволяет удалять данные по API.

Формат результата:

  • Текст - данные с сайта будут переданы в Multy.AI в формате обычного текста.

  • JSON - данные с сайта будут переданы в Multy.AI в формате JSON.

  • Файл - данные с сайта будут переданы в Multy.AI в формате файла.

Переключатели:

  • Добавить заголовки запроса - позволяет передавать заголовки для сайта указанного в запросе. Например, для создания заказов в платежной системе. Передача заголовков позволяет проверять: не был ли подделан запрос злоумышленником и действительно ли его создал администратор. В примере: передан заголовок Authorization с значением: YOUR_TOKEN в формате текста.

  • Добавить параметры запроса - позволяет передавать параметры для сайта указанного в запросе. Например, для создания заказов в платежной системе. В примере: передан параметр user с заначением: Vasya в формате текста. т.е. передали имя клиента. Аналогично передали возраст age и признак клиента.

Рассмотрим подробнее:

Параметр - название параметра. Тут вводим название параметра, например: user

Текст - в выпадающем меню выбираем тип параметра: Текст, число, целое число, True/False, массив и JSON.

  • Текст - значение параметра будет передано текстом.

  • Число -значение параметра будет передано числом.

  • Целое число -значение параметра будет передано целым числом.

  • True /False - параметр будет передан только либо True, либо False.

  • Массив - значение параметра будет массивом.

  • JSON - значение параметра будет передано в виде JSON.

Значение - значение параметра. Здесь указываем значение. Например, для примера выше Vasya.

Добавить параметры в JSON формате - позволяет передавать данные в JSON формате. Пример данных:

{"user":"Vasya","age":28,"is_client":true}

Важно! Для составления JSON рекомендуется использовать специальный сайт. Например, этот. Перезаписывать параметры рекурсивно - рекурсивная перезапись погружается внутрь объектов и дополняет их или переписывает только их части. Сохранять результат в переменную - позволяет сохранить результат в переменную для дальнейшей обработки. Например, вы получили данные в формате JSON и сохранили результат в переменную data. тогда чтобы достать например имя пользователя достаточно отправить сообщение: {var:data.user}

Last updated