Gérer les webhooks

Les webhooks poussent les événements de réservation et de technicien vers votre point de terminaison en temps réel — enregistrez une URL et une clé de signature, et CrispHive livre les événements au fil de l’eau.

Enregistrer un point de terminaison

Vous enregistrez une URL HTTPS accessible publiquement ainsi qu’une clé de signature ; les actions du système poussent alors des événements JSON vers cette URL. Les livraisons en échec sont réessayées avec un backoff exponentiel.

Vérifier les signatures

Chaque livraison inclut un en-tête X-CrispHive-Signature. Recalculez le HMAC-SHA256 du corps brut avec votre clé de signature et comparez en temps constant avant de faire confiance à la charge utile.

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));
}

Catalogue des événements