Fehler
# Fehler
HTTP-Statuscodes und Fehlerantworten auswerten.
## Fehlerformat
```json
{
"code": 400,
"message": "Use a project slug, not an ID"
}
```
`message` beschreibt die Ursache. Werte bei der Fehlerbehandlung den HTTP-Status aus, statt dich auf einen bestimmten Meldungstext zu verlassen.
| Status | Ursache und nächster Schritt |
| --- | --- |
| 400 | Ungültiger Body, Slug, Feldtyp oder Pipeline-Graph. Eingaben korrigieren. |
| 401 | Authentifizierung fehlt, ist ungültig oder abgelaufen. Token prüfen. |
| 403 | Token gehört zu einem anderen Projekt oder Projektzugriff fehlt. Zuordnung prüfen. |
| 404 | Projekt, Event, Profil oder Step existiert nicht bzw. ist nicht zugänglich. Referenz prüfen. |
| 409 | Action-Limit, Ablauf, Step-Abhängigkeit, geschlossene Pipeline oder konkurrierende Änderung. Zustand lesen und fachlich prüfen. |
| 413 | Request oder Profilbild zu groß. Datenmenge reduzieren. |
| 500 | Serverfehler. Fehlerzeitpunkt und Request-Kontext ohne Zugangsdaten für die Diagnose festhalten. |
## Action-Ergebnisse
Ein ausgeführter Webhook kann bei HTTP `200` ein Action-Ergebnis mit `success: false` liefern. Prüfe neben dem HTTP-Status auch das fachliche Ergebnis und die protokollierten Erwartungen.
## Wiederholungen
Ein Verbindungsabbruch beweist nicht, dass der Request fehlgeschlagen ist. Event-Erstellung, Inkremente und Actions können bei Wiederholung zusätzliche Seiteneffekte auslösen. Siehe [Fehlerbehebung](/docs/guides/troubleshooting).
HTTP-Statuscodes und Fehlerantworten auswerten.
Fehlerformat
{
"code": 400,
"message": "Use a project slug, not an ID"
}message beschreibt die Ursache. Werte bei der Fehlerbehandlung den HTTP-Status aus, statt dich auf einen bestimmten Meldungstext zu verlassen.
| Status | Ursache und nächster Schritt |
|---|---|
| 400 | Ungültiger Body, Slug, Feldtyp oder Pipeline-Graph. Eingaben korrigieren. |
| 401 | Authentifizierung fehlt, ist ungültig oder abgelaufen. Token prüfen. |
| 403 | Token gehört zu einem anderen Projekt oder Projektzugriff fehlt. Zuordnung prüfen. |
| 404 | Projekt, Event, Profil oder Step existiert nicht bzw. ist nicht zugänglich. Referenz prüfen. |
| 409 | Action-Limit, Ablauf, Step-Abhängigkeit, geschlossene Pipeline oder konkurrierende Änderung. Zustand lesen und fachlich prüfen. |
| 413 | Request oder Profilbild zu groß. Datenmenge reduzieren. |
| 500 | Serverfehler. Fehlerzeitpunkt und Request-Kontext ohne Zugangsdaten für die Diagnose festhalten. |
Action-Ergebnisse
Ein ausgeführter Webhook kann bei HTTP 200 ein Action-Ergebnis mit success: false liefern. Prüfe neben dem HTTP-Status auch das fachliche Ergebnis und die protokollierten Erwartungen.
Wiederholungen
Ein Verbindungsabbruch beweist nicht, dass der Request fehlgeschlagen ist. Event-Erstellung, Inkremente und Actions können bei Wiederholung zusätzliche Seiteneffekte auslösen. Siehe Fehlerbehebung.