Запуск процессов по внешним запросам

В последнем обновлении Бипиума, выпущенном в начале декабря, мы добавили 2-й тип событий для запуска процессов — внешние запросы.

Бипиум научился принимать любые веб-запросы с произвольной структурой параметров, и запускать на эти запросы процессы, которые могут обработать данные и вернуть результат инициатору запроса.

fb_processes_scheme

Как применить

Заявки с сайта. Посетитель вашего сайта заполняет форму, например, форму заказа или заявки на обратный звонок. Эти данные сайт отправляет в Бипиум, который запустит процесс, передав эти данные. Процесс обработает полученные данные и, например, сохранит их в каталоге заказов.

Обработка вебхуков других сервисов. Многие сервисы в интернете: профессиональные сервисы, бухгалтерские сервисы,  соцсети и месенджеры имеют собственное API. Это значит, что другая система может обращаться к ним для получения или изменения данных. Помимо API многие сервисы имеют механизм вебхуков — это когда сам сервис отправляет какие-то данные внешним системам: например сигнал о новом сообщении, изменении данных или сформированном счете. Все сервисы отправляют данные в уникальном для них формате. Бипиум может получать такие запросы и обрабатывать любые полученные данные.

Как настроить

Бипиум позволяет создать множество точек приему внешних запросов, на каждую точку он запускает свой сценарий.

  1. В разделе «Управление» в каталоге «Сценарии» создайте новый сценарий, который будет обрабатывать полученные данные.
  2. В разделе «Управление» в каталоге «Внешние запросы» создайте новую запись. Укажите адрес точки приема запросов и выберите созданный сценарий, который будет запускаться при входящем запросе.

Какие данные получает процесс

Процесс получает все данные входящего HTTP-запроса:

  • Метод запроса (GET, POST, PATCH,…)
  • GET-параметры запроса, переданные в URL (?param=value)
  • Заголовки HTTP-запроса (Headers)
  • Куки (Cookies)
  • POST-параметры

Для удобства все данные процесс получает в виде отформатированных объектов.

Какие данные процесс возвращает запросу

Процесс формирует ответ на запрос, который возвращается инициатору (сайту или внешней системе). Процесс может вернуть:

  • Код ответа (200, 404 или любой другой)
  • Заголовки HTTP-ответа (Headers)
  • Тело ответа (Body)

Подробнее о схеме работы читайте в документации в статье «Внешние запросы».

Поделиться
Плюсануть

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

Можно использовать следующие HTML-теги и атрибуты: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>