Fehler & Konventionen

Content-Type

Alle Endpunkte akzeptieren und liefern application/json. Senden Sie bei jeder Anfrage mit einem Body einen Content-Type: application/json-Header.

Antwort-Umschlag

Die meisten Endpunkte liefern einen Ergebnis-Umschlag mit einem booleschen success-Flag, einer menschenlesbaren message und einem Ressourcenfeld, das nach der Operation benannt ist (leads, job, …). Bei einem Fehlschlag ist das Ressourcenfeld null:

{
  "success": true,
  "message": "Leads added successfully",
  "leads": [ /* ... */ ]
}

{
  "success": false,
  "message": "At least one lead must be provided",
  "leads": null
}

Häufige Fehlermeldungen

Situation	message
Fehlender Auth-Header	Authorization header missing
Ungültiges / abgelaufenes Token	Invalid or expired authentication token
Fehlerhafter Body	Invalid request format: ...
Ressource aus anderem Projekt	... does not belong to your project
Server- / Datenbankfehler	Failed to ...: ...

Statuscodes

Code	Bedeutung
200	Erfolg.
400	Ungültiges Anfrageformat oder Validierungsfehler.
401	Fehlendes/ungültiges Token oder Ressource gehört zu einem anderen Projekt.
404	Ressource innerhalb Ihres Projekts nicht gefunden.
500	Unerwarteter Serverfehler.

hinweis

Einige Endpunkte signalisieren Validierungsfehler innerhalb eines 200-Antwort-Umschlags (success: false) anstatt mit einem 4xx-Status. Prüfen Sie stets das success-Flag zusätzlich zum HTTP-Status.