API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Webhooks

Webhooks

Lesedauer · 6 Min.Aktualisiert · 2026-05-01

Webhooks sind die push-basierte Alternative zum Polling. Statt periodisch zu fragen „gibt es neue Tickets?“ registrieren Sie eine URL, die Codemeta OS benachrichtigt, sobald etwas passiert.

Lifecycle

  1. Registrieren. Sie legen eine Webhook-Subscription pro Mandant an, mit Ziel-URL, Event-Filtern und einem Secret.
  2. Empfangen. Codemeta OS schickt POST-Requests an Ihre URL.
  3. Verifizieren. Sie prüfen X-Webhook-Signature.
  4. Antworten. 2xx → erledigt. 4xx/5xx → wird mit Backoff retryt.

Authentizität

Jeder Request enthält den Header X-Webhook-Signature. Der Wert ist der HMAC-SHA256-Hex-Digest über den rohen Request-Body, gebildet mit dem Secret aus der Subscription.

X-Webhook-Signature: 91bb1b3f5e4a4b6c…

Verifizieren Sie ihn vor jeder Verarbeitung. Mehr im Tutorial: Webhook-Empfänger absichern.

Retries und Reihenfolge

  • Retry-Backoff. Bei nicht-2xx oder Timeout wiederholt Codemeta OS die Auslieferung mit exponentiellem Backoff.
  • Mehrfachzustellung möglich. Verarbeiten Sie idempotent. Jedes Event hat eine eindeutige id, die Sie zur Deduplizierung nutzen können.
  • Reihenfolge nicht garantiert. Events können in einer anderen Reihenfolge ankommen, als sie auf der Plattform passiert sind. Verlassen Sie sich nicht auf die Empfangsreihenfolge.

Body-Format

{
  "id": "0193f1a2-…",
  "type": "ticket.created",
  "tenantId": "0192f2c0-…",
  "createdAt": "2026-05-01T12:34:56.789Z",
  "data": {
    "id": "01938421-…",
    "schema": "ticket",
    "version": 1
  }
}

data enthält genug Information für die meisten Anwendungsfälle. Wenn Sie das vollständige aktuelle Objekt brauchen, holen Sie es per GET direkt.

Was sich noch ändert

Codemeta OS ist vor dem öffentlichen Launch. Der Event-Katalog wird laufend ergänzt. Neue Event-Typen werden additiv eingeführt; bestehende Typen ändern ihr Format nicht ohne Versionierung.

Weiterlesen

Suche