Как передать данные из формы и выполнять запросы на URL-адрес
В этой статье вы узнаете про новый способ передачи данных из формы на удаленный URL адрес - Вебхук. С помощью вебхука можно обмениваться информацией со сторонними ресурсами. Например, сделать вызов своего отдельного URL-адреса или переслать на этот адрес данные из формы.
Вебхуки позволяют интегрировать рабочие процессы между системами/сервисами/приложениями (включая вызовы между различными проектами внутри системы QuintaDB). Это отличное подспорье для организации бизнес-процессов и мы уверены, что вы найдете множество способов воспользоваться преимуществами вебхуков.
Использовать Вебхук можно с помощью:
- поля Действие;
- модуля Действие по условию.
Рассмотрим на примере как это работает. В качестве примера будем использовать приложение Контент-агентство, которое можно установить на странице шаблонов приложений.
Также, для демонстрации мы будем использовать сервис webhook.site. Это может быть любой ваш URL-адрес.
Скопируйте свой уникальный URL. Теперь перейдем к форме Статьи в нашем приложении Контент-агенство.
Рассмотрим первый способ - поле "Действие":
1. Добавьте на форму поле "Действие" (вкладка "Дополнительные");
2. Откройте страницу редактирования настроек поля. Перейдите во вкладку "Задачи" или выберите пункт "Что делать";
3. Создайте новую задачу. Выберите тип задачи - Вебхук;
4. Перейдите в раздел "Настройки".
Здесь необходимо вставить URL-адрес (в данном примере - это URL, полученный на сервисе webhook.site).
Выберите метод передачи данных (GET, POST, PATCH, DELETE). Подробнее о методах передачи данных, читайте документацию по API.
Выберите Content-Type (multipart/form-data, application/x-www-form-urlencoded, application/json).
В этом примере мы используем метод - POST и тип - application/json.
4. В разделе "Заголовки запроса" вы можете добавить заголовок и данные для авторизации (опционально);
5. В разделе Параметры запроса нужно указать название параметра и выбрать поле из формы напротив:
Также, вы можете выбрать из списка "Своё значение". Таким образом, вы передаете произвольный параметр, вместо значения из формы.
6. Нажмите кнопку "Создать".
7. Для тестирования нажимаем на "Действие" в таблице:
8. Проверяем результат передачи данных на сервисе Webhook:
Все данные успешно переданы.
Теперь рассмотрим другой метод передачи данных через Вебхук. А именно - модуль "Действия по условию".
Для демонстрации используем эту же форму.
1. Перейдите в Конструктор формы и откройте вкладку "Действия". Создайте новое условное действие.
2. Выберите критерий выполнения действия (например, поле Название не пусто).
- Укажите название и когда выполнять действие (Форма отправлена, Запись обновлена, Платеж завершен или одновременно все).
- Действие - Вебхук.
Обратите внимание: в данном случае, при заполнении формы не происходит переход на другую страницу, а все данные параллельно сохраняются в вашей базе QuintaDB.
3. После создания действия нажмите на кнопку "Редактировать":
4. Нажмите на кнопку "Редактировать" напротив действия "Вебхук". Далее необходимо настроить вебхук аналогично настройкам в поле Действие.
Обратите внимание: каждый раз при передачи данных вы используете API вызов из ресурсов вашего аккаунта.