Отправить запрос на внешний сайт
Действие позволяет отправить запрос на любой внешний сайт / сервис, у которого есть API.
Например, с помощью этого действия можно отправлять информацию в любые сервисы:
- CRM
- Цитаты, анекдоты, гороскопы
- Статистические сервисы: гугл-таблицы, airtable и т.д.
- Платежные системы
- Искусственный интеллект
- и т.д.
Вы можете интегрировать Multy.AI через запросы прямо сейчас абсолютно с любым сервисом, не дожидаясь пока необходимый функционал будет добавлен.
Рассмотрим действие подробнее:
На самом деле тут все просто:
- URL адрес - адрес на который необходимо отправлять запрос. Это может быть сайт с цитатами, шутками, гороскопом, прогнозом погоды или даже платежной системы. Для проверки корректности данных можете использовать сайт: https://httpbin.org/anything И отправлять запросы на него.
Метод отправки:
- GET - данные будут отправлены методом GET. Т.е. как будто пользователь открыл страницу в браузере.
- JSON POST - данные будут отправлены методом POST в виде JSON-объекта. Например, вы отправляете параметры: user=Vasya&age=28, то они будут переданы сайту в таком формате: {"user": "Vasya", "age": 28}
- FORM POST - данные будут отправлены методом POST. Будто пользователь заполнил форму на вашем сайте. В большинстве случаев для отправки данных достаточно использовать
- PHP POST - данные будут отправлены методом POST в PHP стиле многоуровневой вложенности параметров. Может быть использовано для совместимости со старыми сайтами, написанными на PHP.
- PUT - данный метод позволяет частично изменять в запросе данные по API.
- PATCH - данный метод позволяет редактировать в запросе данные по API.
- DELETE - данный метод позволяет удалять данные по API.
Формат результата:
- Текст - данные с сайта будут переданы в Multy.AI в формате обычного текста.
- JSON - данные с сайта будут переданы в Multy.AI в формате JSON.
- Файл - данные с сайта будут переданы в Multy.AI в формате файла.
Переключатели:
- Добавить заголовки запроса - позволяет передавать заголовки для сайта указанного в запросе. Например, для создания заказов в платежной системе. Передача заголовков позволяет проверять: не был ли подделан запрос злоумышленником и действительно ли его создал администратор. В примере: передан заголовок Authorization с значением: YOUR_TOKEN в формате текста.
- Добавить параметры запроса - позволяет передавать параметры для сайта указанного в запросе. Например, для создания заказов в платежной системе. В примере: передан параметр user с значением: Vasya в формате текста. т.е. передали имя клиента. Аналогично передали возраст age и признак клиента.
Рассмотрим подробнее:
Параметр — название параметра. Тут вводим название параметра, например: user
Текст - в выпадающем меню выбираем тип параметра:
- Текст - значение параметра будет передано текстом.
- Число -значение параметра будет передано числом.
- Целое число -значение параметра будет передано целым числом.
- True /False - параметр будет передан только либо True, либо False.
- Массив - значение параметра будет массивом.
- JSON - значение параметра будет передано в виде JSON.
Значение - значение параметра. Здесь указываем значение. Например, для примера выше Vasya.
Добавить параметры в JSON формате - позволяет передавать данные в JSON формате.
Пример данных: {"user":"Vasya","age":28,"is_client":true}
Важно!
Для составления JSON рекомендуется использовать специальный сайт. Например, этот: https://jsonformatter.org
Перезаписывать параметры рекурсивно - рекурсивная перезапись погружается внутрь объектов и дополняет их или переписывает только их части.
Сохранять результат в переменную - позволяет сохранить результат в переменную для дальнейшей обработки.
Например, вы получили данные в формате JSON и сохранили результат в переменную data. тогда чтобы достать например имя пользователя достаточно отправить сообщение: {var:data.user}
Переменные результата
{var:ok}
- Происходили ли ошибки при обработке параметров запроса
{var:result}
- Тело ответа в формате, который выбран в параметрах (например, текст или json)
- Переменная перезаписывается любым следующим действием
{var:effect.http_code}
- HTTP код (статус) ответа (например: 200, 201, 400)
- Перезаписывается следующим запросом (если такой есть)