Un webhook proporciona a otras aplicaciones información basada en eventos, la cual se envía como una solicitud HTTPS que se puede usar para crear flujos de trabajo automáticos e integradores. En las siguientes secciones, se describen con más detalle algunos de los conceptos clave de los flujos de trabajo de los webhooks de ArcGIS Enterprise.
Desencadenador de evento
Un desencadenador de evento especifica las operaciones de la API que invocarán el webhook. Los webhooks de organización y de servicios de entidades admiten una variedad de desencadenadores de eventos a los que puede suscribirse. Por ejemplo, puede configurar que el webhook de su organización se desencadene cuando se actualice un grupo específico o, en el caso de un webhook de servicio de entidades, puede elegir que el webhook se desencadene cuando se actualice la definición de un servicio de entidades. No obstante, los webhooks de servicios de geoprocesamiento no utilizan una lista de desencadenadores de eventos a los que los usuarios puedan suscribirse. En su lugar, los webhooks de servicios de geoprocesamiento devuelven cargas cuando se completa un trabajo de un servicio de geoprocesamiento. Para obtener más información sobre la lista admitida de desencadenadores de eventos para webhooks de organización y de servicios de entidades, consulte el tema Desencadenadores de eventos.
Carga
Cuando un usuario realiza una operación que se especificó como un desencadenador de evento, el webhook envía la información del evento, también conocida como carga, a la URL de carga especificada. La información del evento de cada tipo de webhook se envía en un esquema JSON similar que contiene la información del evento y de cuándo ocurrió el evento, aunque la estructura y las propiedades de la carga devueltas para los webhooks de organización y de servicios varían según el tipo de webhook. Para obtener más información sobre las cargas de cada tipo de webhook, consulte Cargas.
URL de carga
Una vez invocado un webhook, la carga se envía a una URL específica, a menudo proporcionada por el receptor de webhook. La URL de carga se proporciona al configurar un webhook y se comprueba durante la creación para garantizar que ArcGIS Enterprise pueda acceder al receptor con una solicitud POST de HTTPS.
Receptores
Las cargas se envían a los receptores del webhook, que recuperan la carga y comunican a los administradores o a los miembros de la organización que el evento ha tenido lugar. Los receptores del webhook se deben configurar para que se comuniquen mediante una conexión HTTPS para recibir cargas y que ArcGIS Enterprise pueda acceder a ellos. Existen algunas opciones que son compatibles con los receptores, como receptores de servicios web de terceros (Microsoft Power Automate, Zapier e IFFT) y servicios web personalizados. Para obtener ejemplos de cómo crear servicios web personalizados o empezar a utilizar receptores de terceros, consulte el repositorio de webhooks.