Ключевые концепции вебхуков

Вебхук предоставляет другим приложениям управляемую событиями информацию, доставляемую в виде запроса HTTPS, которую можно использовать для создания автоматизированных и интегрированных рабочих процессов. В следующих разделах более подробно описываются некоторые ключевые концепции в рабочих процессах вебхуков ArcGIS Enterprise.

Триггер событий

Триггер события определяет операции API, которые будут вызывать вебхук. Вебхуки и организации, и сервиса объектов поддерживают различные триггеры событий, на которые можно подписаться. Например, можно задать, чтобы вебхук организации вызывался при обновлении определенной группы, или для вебхука сервиса объектов можно выбрать, чтобы вебхук запускался при обновлении определения сервиса объектов. Однако вебхуки сервиса геообработки не используют список триггеров событий, на которые могут подписаться пользователи. Наоборот, вебхуки сервисов геообработки доставляют полезные данные всякий раз по завершении задания сервиса геообработки. Более подробно о поддерживаемом списке триггеров событий для вебхуков организации и сервиса объектов см. раздел Триггеры событий.

Полезные данные

Когда пользователь выполняет операцию, которая указана как триггер события, вебхук доставляет информацию о событии, называемую также полезными данными, по указанному целевому URL-адресу. Информация о событии для каждого типа вебхука доставляется в аналогичной схеме JSON, содержащей информацию о событии и о том, когда оно произошло, хотя структура и свойства полезных данных, возвращаемые для вебхуков организации и сервиса, различаются в зависимости от типа вебхука. Более подробно о полезных данных для каждого типа вебхуков см. Полезные данные.

Целевой URL

Как только вебхук вызван, полезные данные доставляются по определенному URL-адресу, часто предоставляемому получателем вебхука. Целевой URL-адрес предоставляется при настройке вебхука и проверяется при создании, чтобы гарантировать, что получатель достижим для ArcGIS Enterprise по запросу HTTPS POST.

Получатели

Полезные данные доставляются получателям вебхука, которые извлекают полезные данные и сообщают о том, что событие произошло, администраторам или участникам организации. Получателей вебхука необходимо настроить на коммуникацию по соединению HTTPS, чтобы получать полезные данные и быть доступными для ArcGIS Enterprise. Существует несколько опций, поддерживаемых для приемников, таких как приемники сторонних веб-сервисов (Microsoft Power Automate, Zapier и IFFT), пользовательские веб-сервисы. Примеры того, как можно создать пользовательские веб-сервисы или начать использовать сторонние приемники, см. в Репозиторий вебхука.