Introdução à Webhook
Os webhooks são uma ferramenta poderosa para automatizar e sincronizar a comunicação entre sistemas em tempo real. Com a API de webhooks da Merx, você pode receber notificações instantâneas sobre eventos específicos que ocorrem em nosso sistema, como a criação de um novo produtor, a atualização de um armazém ou até mesmo a realização de uma nova transação.
Ao integrar os webhooks da Merx em seu sistema, você pode definir endpoints para receber automaticamente notificações sempre que eventos relevantes ocorrerem em nossa plataforma. Isso permite uma integração contínua e em tempo real entre seus sistemas e a plataforma da Merx.
Exemplos de eventos que você pode receber notificações incluem a criação de um novo produtor, a atualização de um armazém ou até mesmo a realização de uma nova transação.
Para começar a utilizar os webhooks da Merx, basta configurar os endpoints em seu sistema para receber as notificações.
Antes de subir seu endpoint receptor
Toda entrega chega com os headers app-hash (identificador da cooperativa), event-type (nome do evento, a única forma de distinguir eventos numa mesma URL) e Content-Hmac (assinatura, que não serve para validar a entrega — ver o guia), além de Content-Type: application/json. O endpoint precisa responder 2xx em menos de 5 segundos — passado esse tempo a entrega é tratada como falha.
Responder 5xx devolve a mensagem à fila e ela é reentregue; responder 4xx encerra a entrega em definitivo. Os detalhes estão em Guia: Webhooks — Requisitos do endpoint receptor.