Webhooks verarbeiten

Webhooks übermitteln Buchungs- und Techniker-Ereignisse in Echtzeit an Ihren Endpunkt — registrieren Sie eine URL und einen Signaturschlüssel, und CrispHive liefert Ereignisse, sobald sie eintreten.

Endpunkt registrieren

Sie registrieren eine öffentlich erreichbare HTTPS-URL zusammen mit einem Signaturschlüssel; Systemaktionen senden dann JSON-Ereignisse an diese URL. Fehlgeschlagene Zustellungen werden mit exponentiellem Backoff erneut versucht.

Signaturen verifizieren

Jede Zustellung enthält einen X-CrispHive-Signature-Header. Berechnen Sie den HMAC-SHA256 des rohen Bodys mit Ihrem Signaturschlüssel neu und vergleichen Sie in konstanter Zeit, bevor Sie der Payload vertrauen.

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

Ereigniskatalog