1. Encuentra una calculadora
  2. Introduce números y unidades
  3. Lee el resultado y confía en él
  4. Guarda, comparte e incrusta
  5. Crea con la API
  6. Cuenta y plan
  7. Privacidad y tus datos
  8. Soluciona un problema

Verificar la firma de un webhook

Construye la cadena t.body a partir del encabezado X-CalcLib-Signature, calcula HMAC-SHA256 con tu secreto y compara antes de procesar el envío.

Tokens de API, uso, el servidor MCP para agentes de IA y webhooks.

Un endpoint de webhook añadido en Webhooks recibe un POST firmado cada vez que alguien usa tu inserción. Cada envío incluye un encabezado X-CalcLib-Signature con el formato t=<unix time>,v1=<signature>.

Verifica antes de analizar

  1. Lee el cuerpo sin procesar de la solicitud. Si analizas el JSON y lo vuelves a serializar, cambian los bytes y la firma nunca coincidirá.
  2. Toma t del encabezado y construye la cadena t.body: la marca de tiempo, un punto y el cuerpo sin procesar.
  3. Calcula el HMAC-SHA256 de esa cadena con el secreto de tu endpoint, en formato hexadecimal.
  4. Compáralo con cada valor v1 en tiempo constante. Mientras rotas un secreto, el encabezado puede incluir dos valores v1; cualquiera de ellos puede coincidir.
  5. Rechaza el envío si t difiere en más de 5 minutos de la hora de tu reloj.

Envíos que fallan

Se reintentan al cabo de 1 minuto, 5 minutos, 30 minutos, 2 horas y 8 horas. Un endpoint que falla 20 veces seguidas se desactiva y te enviamos un correo, según el ajuste de producto en Notificaciones.

¿Te ha resultado útil este artículo?

¿Sigues atascado? Contactar con soporte · Centro de ayuda