Los webhooks le permiten suscribirse a eventos que ocurren en un sistema de software y recibir automáticamente una entrega de datos en su servidor cada vez que ocurren esos eventos.
Los webhooks se utilizan para recibir datos a medida que ocurren, a diferencia de sondear una API (llamar a una API de manera intermitente) para ver si hay datos disponibles. Con los webhooks, solo necesita expresar interés en un evento una vez, al crear el webhook.
Acerca de los webhooks en Fluid
Cuando crea un webhook, especifica una URL y se suscribe a eventos que ocurren en Fluid. Cuando ocurre un evento al que su webhook está suscrito, Fluid enviará una solicitud HTTP con datos sobre el evento a la URL que especificó. Si su servidor está configurado para escuchar las entregas de webhooks en esa URL, puede tomar medidas cuando reciba una.
En un tablero de Fluid, los eventos se basan en las Acciones/Tarjetas que forman parte del tablero. Los eventos admitidos son Crear, Actualizar y Eliminar. Cada vez que uno de estos eventos ocurre en una Acción del tablero, se llamará a su webhook. Para crear un webhook, consulte Cómo configurar webhooks para la integración con tableros de Fluid
Elegir entre webhooks o la API REST
Usar webhooks tiene las siguientes ventajas sobre usar la API:
-
Los webhooks requieren menos esfuerzo y menos recursos que sondear una API.
-
Los webhooks escalan mejor que las llamadas a la API. Si necesita monitorear muchos recursos, llamar a la API para cada recurso puede hacer que alcance rápidamente su cuota de límite de tasa de la API. En su lugar, puede suscribirse a varios eventos de webhook y recibir información solo cuando ocurre un evento.
-
Los webhooks permiten actualizaciones casi en tiempo real, ya que se activan cuando ocurre un evento.
-
Si solo necesita información una vez o de manera intermitente, o solo desea obtener información de un conjunto pequeño de recursos sin planes de escalar, puede llamar a la API cuando necesite la información relevante.
Lecturas adicionales