Webhooks permitem que você assine eventos que ocorrem em um sistema de software e receba automaticamente uma entrega de dados no seu servidor sempre que esses eventos ocorrerem.
Webhooks são usados para receber dados assim que acontecem, ao contrário de fazer polling em uma API (chamando uma API intermitentemente) para verificar se os dados estão disponíveis. Com webhooks, você só precisa expressar interesse em um evento uma vez, quando cria o webhook.
Sobre webhooks no Fluid
Quando você cria um webhook, especifica uma URL e assina eventos que ocorrem no Fluid. Quando um evento ao qual seu webhook está inscrito ocorre, o Fluid enviará uma requisição HTTP com dados sobre o evento para a URL que você especificou. Se o seu servidor estiver configurado para escutar entregas de webhook nessa URL, ele poderá tomar uma ação quando receber uma.
Em um quadro do Fluid, os eventos são baseados nas Ações/Cartões que fazem parte do quadro. Os eventos suportados são Criar, Atualizar e Excluir. Sempre que um desses eventos ocorrer em uma Ação do quadro, seu webhook será chamado. Para criar um webhook, consulte Como configurar a integração de Webhooks com os Quadros do Fluid
Escolhendo webhooks ou a API REST
O uso de webhooks tem as seguintes vantagens em relação ao uso da API:
Webhooks exigem menos esforço e menos recursos do que fazer polling em uma API.
Webhooks escalam melhor do que chamadas de API. Se você precisar monitorar muitos recursos, chamar a API para cada recurso pode fazer com que você atinja rapidamente sua cota de limite de taxa da API. Em vez disso, você pode assinar vários eventos de webhook e receber informações somente quando um evento acontecer.
Webhooks permitem atualizações em tempo quase real, pois são acionados quando um evento ocorre.
Se você precisar de informações apenas uma vez ou intermitentemente, ou quiser obter informações apenas de um pequeno conjunto de recursos sem planos de escalar, você pode chamar a API quando precisar das informações relevantes.