Copy page

Entwickler

Webhook-Benachrichtigungen

Was ein Costfluent-Webhook-Kanal für jede Art von Benachrichtigung an deinen Endpunkt sendet und wie du die Arten und die Wiederholungen unterscheidest.

Ein Webhook-Kanal sendet jede Benachrichtigung als JSON an deinen Endpunkt. Benachrichtigungskanäle beschreibt, wie du den Kanal hinzufügst und festlegst, was an ihn geht; diese Seite beschreibt, was dein Endpunkt empfängt.

Bevor du beginnst

Verfügbar im Starter-, Core-, Optimize- und Scale-Tarif. Tarife vergleichen

• Dein Endpunkt ist unter einer öffentlichen Adresse erreichbar und antwortet innerhalb von 10 Sekunden.

Die Anfrage

Jede Benachrichtigung ist ein POST mit einem JSON-Body:

Code
{
  "event_type": "budget_alert",
  "schema_version": 1,
  "subject": "Budget 'Platform' reached 80% threshold",
  "content": "Current spend: EUR 825.00 of EUR 1,000.00",
  "html_content": "<p>Current spend: <b>EUR 825.00</b> of EUR 1,000.00</p>",
  "timestamp": "2026-10-12T09:00:00.0000000Z",
  "app_id": "app_Xk2pQ9vLr4mN8tY1wZ3aBc"
}

Feld	Bedeutung
event_type	Worum es in der Benachrichtigung geht; siehe die Tabelle unten. Verzweige danach statt nach dem Betreff.
schema_version	Die Version dieses Bodys. Sie ist 1 und steigt nur, wenn ein Feld seine Bedeutung ändert oder wegfällt; ein neues Feld oder ein neuer Ereignistyp erhöht sie nicht.
subject, content, html_content	Die Benachrichtigung, wie ein Mensch sie liest, als Klartext und als HTML. Der Wortlaut kann sich ändern.
timestamp	Wann dieser Versuch gesendet wurde, in UTC.
app_id	Der Kanal, an den die Benachrichtigung ging.

Die Anfrage trägt zwei Header:

Header	Wert
X-Costfluent-Event	Der event_type, damit ein Router verteilen kann, ohne den Body zu lesen.
X-Costfluent-Delivery	Bei jedem Versuch derselben Benachrichtigung gleich, damit dein Endpunkt eine Wiederholung verwerfen kann. Ein Kanaltest hat keinen.

Ereignistypen

event_type	Gesendet, wenn
budget_alert	Ein Budget einen seiner Schwellenwerte überschreitet.
cost_alert	Eine Warnung für Ausgabenschwelle, ungewöhnliche Änderung oder Tag-Abdeckung auslöst.
anomaly	Eine Kostenanomalie in einem Workspace erkannt wird, dessen Anomalie-Benachrichtigungen den Kanal nennen.
channel_test	Jemand beim Kanal Testen wählt.

Wie es sich verhält

• Jede 2xx-Antwort ist eine Zustellung. Ein anderer Status, eine Weiterleitung oder keine Antwort innerhalb von 10 Sekunden ist ein fehlgeschlagener Versuch, der wie unter Benachrichtigungskanäle beschrieben wiederholt wird.
• Einer Weiterleitung wird nie gefolgt.
• Geplante Kostenberichte werden nur per E-Mail zugestellt; kein Webhook empfängt sie.

Verwandte Seiten

• Benachrichtigungskanäle
• Warnungen
• Versionierung der Public API