DevGuideTK
← Trilha Backend

Webhooks

Notificações entre sistemas por HTTP, com assinatura, novas tentativas e entrega duplicada.

Webhook é um aviso que um sistema envia a outro por HTTP quando algo acontece: o provedor de pagamentos faz um POST na sua API dizendo que o pagamento foi aprovado.

Integrações com pagamentos, lojas e repositórios dependem disso, e a entrega pela internet falha, se repete e chega fora de ordem.

  • Quem recebe confere a assinatura sobre o corpo bruto, exatamente como chegou.
  • Um carimbo de tempo assinado impede o reenvio de um aviso antigo.
  • Sem resposta 2xx, o emissor tenta de novo: o mesmo aviso chega mais de uma vez.
  • Quem recebe grava, responde logo e processa depois, sem repetir o efeito.
  • Quem envia protege a própria rede: a URL cadastrada pode apontar para dentro dela.