Webhooks

Webhooks ermöglichen die Benachrichtigung Ihrer Systeme über Ereignisse in CODEFLUSS in Echtzeit.

Übersicht

Webhooks senden HTTP POST-Requests an Ihre konfigurierten Endpunkte, wenn bestimmte Ereignisse eintreten.

Ereignistypen

Ereignis	Beschreibung
`project.created`	Projekt erstellt
`project.updated`	Projekt aktualisiert
`project.deleted`	Projekt gelöscht
`page.published`	Seite veröffentlicht
`page.unpublished`	Seite zurückgezogen
`blog.entry.published`	Blog-Eintrag veröffentlicht
`media.uploaded`	Medium hochgeladen
`website.deployed`	Website deployed

Webhook-Payload

{
  "id": "evt_abc123",
  "type": "page.published",
  "timestamp": "2026-01-23T12:00:00Z",
  "data": {
    "pageId": "page_xyz789",
    "projectId": "proj_abc123",
    "title": "Neue Seite",
    "url": "https://example.com/neue-seite"
  },
  "organizationId": "org_xyz789"
}

Webhook-Signatur

Alle Webhooks werden mit HMAC-SHA256 signiert. Validieren Sie die Signatur:

import crypto from 'crypto';

function verifyWebhookSignature(
  payload: string,
  signature: string,
  secret: string
): boolean {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(`sha256=${expectedSignature}`)
  );
}

Konfiguration

Webhooks werden im CODEFLUSS Dashboard unter Einstellungen → Webhooks konfiguriert.

Hinweis: Die Webhook-Management-API befindet sich in Entwicklung und wird in einer zukünftigen Version verfügbar sein.

Retry-Logik

Bei fehlgeschlagenen Webhook-Zustellungen:

3 Wiederholungsversuche
Exponentielles Backoff (1min, 5min, 30min)
Nach 3 Fehlschlägen: Webhook wird deaktiviert