1. Encontre uma calculadora
  2. Digite números e unidades
  3. Leia o resultado e confie nele
  4. Salve, compartilhe e incorpore
  5. Desenvolva com a API
  6. Conta e plano
  7. Privacidade e seus dados
  8. Resolva um problema

Como verificar a assinatura de um webhook

Monte a string t.body a partir do cabeçalho X-CalcLib-Signature, calcule o HMAC-SHA256 com o seu segredo e compare antes de processar a entrega.

Tokens de API, uso, o servidor MCP para agentes de IA e webhooks.

Um endpoint de webhook adicionado em Webhooks recebe um POST assinado sempre que alguém executa o seu embed. Cada entrega traz um cabeçalho X-CalcLib-Signature no formato t=<unix time>,v1=<signature>.

Verifique antes de interpretar

  1. Leia o corpo bruto da requisição. Interpretar e serializar o JSON de novo altera os bytes, e a assinatura nunca vai coincidir.
  2. Pegue o t do cabeçalho e monte a string t.body: o timestamp, um ponto e o corpo bruto.
  3. Calcule o HMAC-SHA256 dessa string com o segredo do seu endpoint, em hexadecimal.
  4. Compare o resultado com cada valor v1 em tempo constante. Enquanto você faz a rotação de um segredo, o cabeçalho pode trazer dois valores v1; qualquer um deles pode coincidir.
  5. Rejeite a entrega se t estiver a mais de 5 minutos do seu relógio.

Entregas que falham

Elas são reenviadas após 1 minuto, 5 minutos, 30 minutos, 2 horas e 8 horas. Um endpoint que falha 20 vezes seguidas é desativado e enviamos um e-mail a você, de acordo com a opção do produto em Notificações.

Este artigo foi útil?

Ainda com dúvidas? Contactar o suporte · Central de ajuda