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

Действие позволяет отправить запрос на внешний сайт, например, по 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}