Webhook¶
Система принимает вебхуки на порту 18080. Механизм позволяет внешним сервисам отправлять уведомления о событиях в реальном времени без необходимости постоянного опроса.
Настройка отправляющей стороны¶
В сервисе-источнике, который будет отправлять вебхуки, необходимо указать адрес сервера в формате: http://
Настройка приема вебхука¶
Пример конфигурации обработки вебхука
Метод- Метод, используемый в сервисе-источнике для отправки запроса.
Адрес источника- IP адрес сервиса-источника. Необязательный параметр. Используетя для однозначной идентификации отправителя.
Относительный URL-
Относительный URL вебхука в виде /<эндпоинт>/?
. В query параметрах могут передаваться необходимые данные. Для их получения можно использовать плейсхолдер {{.}} Также есть возможность игнорировать значения определенных query параметров, необходимо просто заменить значение на *. Tip
При обработке вебхука система проверяет полный набор query параметров. Поэтому нужно тщательно проверить какие параметры отправляются сервисом-источником и какие указаны в конфигурации. В случае несовпадения набора параметров, вебхук не будет обработан.
Способ обработки payload- Если запрос предусматривает наличие payload, то необходимо указать способ обработки. Подробнее в разделе Обработка ответа.
Аутентификация- При необходимости можно настроить аутентификацию.