Gestione webhooks

Los webhooks envían eventos de reservas y de técnicos a su endpoint en tiempo real — registre una URL y una clave de firma, y CrispHive entregará los eventos a medida que ocurran.

Registre un endpoint

Usted registra una URL HTTPS accesible públicamente junto con una clave de firma; las acciones del sistema envían entonces eventos JSON a esa URL. Las entregas fallidas se reintentan con retroceso exponencial.

Verifique las firmas

Cada entrega incluye un encabezado X-CrispHive-Signature. Recalcule el HMAC-SHA256 del cuerpo sin procesar con su clave de firma y compárelo en tiempo constante antes de confiar en el payload.

import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, signature, signingKey) {
  const expected = createHmac('sha256', signingKey)
    .update(rawBody)
    .digest('hex');
  return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}

Catálogo de eventos