HTTP-запрос. Получение данных → HTTP-запрос. Отправка данных
Принимайте данные, отправленные http-запросом, откуда угодно
формируйте произвольные http-запросы и отправляйте в любые системы, которые имеют свое api и принимают запросы. С их момощью можно создавать контакты, сделки, задачи, отправлять письма и т.д.
Получение данных с помощью http-запросов
Посмотрите видео Произвольные http запросы в качестве входных данных
Вы можете указать в качестве источника данных произвольные HTTP-запросы.
Основные настройки http-запроса
В окне настройки можно указать метод запроса, который будет приниматься. Это может быть GET, POST и др. виды запросов.
Если вам не надо, делать никакого ответа, то на этом настройку входных данных HTTP-запросом можно считать законченой.
Нажмите кнопку "Сохранить" и перейдите к настройке действий обработки.
После нажания на кнопку "Сохранить" будет создан уникальный адрес, на который необходимо будет отправлять HTTP-запросы
Дополнительные настройки
Если вам необходимо, чтобы наш сервер на этот запрос дал какой-нибудь ответ, то тогда необходимо настроить "Параметры ответа".
Можно настроить все необходимые параметры, начиная от "Кода статуса ответа", "Текста статуса ответа" и заканчивая "Параметрами запроса" и "Заголовками запроса".
Важно: Некоторые сайты не позволяют отправлять запросы на любые сайты и требуют в заголовке ответа разрешение. Чтобы сообщить, что мы разрешаем отправлять на наш адрес запросы с любых адресов, необходимо добавить в поле "Загловки ответа" следующую строку:
Access-Control-Allow-Origin:*
Парсинг данных в формате JSON
Если в качестве тела запроса вам будет приходить JSON, то можно получить доступ отдельно к каждому параметру используя действие "JSON-парсер"
Данные, которые поступают в виде JSON, можно парсить.
Для этого необходимо добавить и заполнить "поля JSON":
- Имя - это произвольное имя внутри обработки, в которое мы запишем данные, которые получим из JSON. Оно будет использовано в дальнейших действиях в обработке.
- Путь - это путь до необходимого значения
Пример 1.
Предположим вам приходит JSON следующего содержания:
{ "firstName": "Александр", "phone": "+79090000001", "appealType": { "Code": "101", "Name": "Заказать звонок" }, "appealText": "target_fb" }
Чтобы получить все поля мы должны настроить JSON-парсер следующим образом:
Пример 2.
Если нам приходит JSON где есть массивы
{ "raw": [ { "q": "ab6c5412-5c7f-489d-8d79-173ce632930e", "a": "3f0bb0ea-fc31-4b49-86b5-337ca0cf86da" }, { "q": "d337ecb3-b903-4664-94c1-16acf2c2e3bb", "a": "f3d4933b-6af3-48a9-a836-0173bbbf6415" } ] }
, то получить поле со вторым полем "q" можно следующим образом:
["raw"][1]["q"]
Для каждого из полей можно настроить варианты действий при отстутствии данных. Если в какое-то поле не будет найдено в JSON, то можно прервать выполнение обработки, либо записать туда пустое значение.
Интеграция с произвольными сервисами через API
Многие сервисы имеют свое API и могут принимать http-запросы. С помощью этих запросов можно создавать контакты, заявки, сделки, отправлять письма и т.д.
Набор возможностей определяется сервисом, в который вы собираетесь отправлять запрос.
У каждого сервиса, который имеет свое API и может принимать запросы есть документация. В этой документации подробно описывается каким образом надо формировать запрос, куда отправлять и т.д.
Сформируйте нужный вам http-запрос
С помощью этого действия можно сформировать практически любой http-запрос. Можно задать все необходимые параметры запроса, указать адреса, заголовки, тело запроса и т.д. Ниже мы разберем основные параметры и дополнительные действия, необходимые для этого.
Еще раз отметим, что все подробности указаны в документации того сервиса, куда вы хотите отправлять запрос.
Добавьте действие http-запрос
Параметры запроса
Заполните параметры запроса
Метод
Укажите метод отправки данных. Это может быть POST или GET запрос.
GET-запросы чаще всего используются для получения данных,
POST-запросы чаще для отправки данных. Но метод зависит от того какой запрос ожидает сервер, на который вы будете отправлять HTTP-запрос.
Адрес
Нужно указать адрес, на который будет отправляться запрос. Например, сервис Bizon365 принимает запросы по адресу https://online.bizon365.ru/api/v1/course/student/add
В вашем случае адрес нужно взять из документации сервиса, куда вы хотите отправлять данные.
Тело
Чаще всего в теле запроса отправляют данные в формате "Form Urlencoded" или "JSON".
Если это необходимо, то сначала надо отдельным действием сформировать нужные данные, и потом указать их в этом поле.
Успешные коды статуса:
Укажите коды статуса, при которых надо считать, что запрос выполнился успешно.
По умолчанию это "2**", т.е. все успешные коды
Параметры строки запроса
Перечислите все параметры, которые необходимо добавить в строку запроса. Это могут поля с данными, например, name/phone или другие необходимые параметры.
Заголовки
В заголовках часто передают служебную информацию: коды для авторизации, токены и т.д.
Если в теле запроса вы отправляете данные, то в большинстве случаев необходимо указать тип данных которые вы отправляете.
Если в теле запроса данные в формате "Form Urlencoded", то необходимо добавить заголовок:
Content-Type: application/x-www-form-urlencoded
Если в теле запроса "JSON", то необходимо добавить заголовок:
Content-Type: application/json
Сохраните действие.
Запустите обработку
Нажмите на кнопку "Запустить"
С этого момента данные будут обрабатываться.
Как все будет работать?
- В обработку будут поступать данные из настроенного вами "Источника данных"
- Поочередно будут выполняться все действия, которые вы настроили
- Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"
В случае возникновения каких-либо ошибок в процессе обработки, вы получите письмо-уведомление на email.
Если вы обнаружили ошибку или неточность в описании, либо что-то не понятно, напишите нам в чат на сайте. Мы внесем правки.