У цій статті ви дізнаєтеся про новий спосіб передачі даних з форми на окерму 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.

5. У розділі "Заголовки запиту" можна додати заголовок і дані для авторизації (опціонально);

6. У розділі "Параметри запиту" потрібно вказати назву параметра та обрати поле з форми:

Також ви можете вибрати зі списку "Власне значення". Таким чином, ви передаєте довільний параметр замість значення з форми.

Зверніть увагу: щоб передати власника поточного запису, потрібно додати кастомний параметр "copy_owners" з будь-яким значенням наприклад "1", у розділі Параметри запиту:

7. Натисніть на кнопку "Створити".

8. Для тестування натисніть на "Дію" у таблиці:

9. Перевіряємо результат на сервісі Webhook:

Усі дані успішно передані.

Тепер розглянемо інший метод передачі через Вебхук. А саме – модуль "Дії по умові".

Для демонстрації використовуємо цю саму форму.

1. Перейдіть у Конструктор форми та відкрийте вкладку "Дії". Створіть нову дію.

2. Виберіть критерій виконання дії (наприклад, поле Назва не порожньо).

• Вкажіть назву та коли виконувати дію (Форма заповнена, Запис оновлено, Платіж завершений або одночасно всі).
• Дія – Вебхук.

Зверніть увагу: в даному випадку при заповненні форми не відбувається перехід на іншу сторінку, а всі дані паралельно зберігаються у вашій базі QuintaDB.

3. Після створення дії натисніть кнопку "Редагувати":

4. Натисніть кнопку "Редагувати" навпроти дії "Вебхук". Далі необхідно налаштувати вебхук аналогічно до налаштувань у полі Дія.

Зверніть увагу: щоразу при передачі даних ви використовуєте API виклик з вашого акаунту.