Fehlercodes und ihre Bedeutung

HTTP-Statuscodes

• 400 Bad Request – Ungültige oder fehlende Parameter im Request
• 401 Unauthorized – Fehlender oder ungültiger API-Key
• 403 Forbidden – Keine Berechtigung für diese Aktion
• 404 Not Found – Ressource existiert nicht
• 409 Conflict – Konflikt (z. B. Slug bereits vergeben)
• 422 Unprocessable Entity – Validierungsfehler
• 429 Too Many Requests – Rate Limit überschritten
• 500 Internal Server Error – Serverfehler, bitte Support kontaktieren

Anwendungsspezifische Fehlercodes

• ERR_SLUG_TAKEN – Dieser Slug ist bereits vergeben
• ERR_IMAGE_TOO_LARGE – Bild überschreitet 10 MB
• ERR_IMAGE_FORMAT – Nicht unterstütztes Bildformat
• ERR_LISTING_EXPIRED – Anzeige ist abgelaufen
• ERR_USER_BANNED – Nutzerkonto gesperrt
• ERR_QUOTA_EXCEEDED – Maximale Anzahl an Anzeigen erreicht

Fehlermeldungen debuggen

Alle API-Fehler enthalten im Body ein error-Feld mit dem maschinenlesbaren Code und ein message-Feld mit einer menschenlesbaren Beschreibung:

{
  "error": "ERR_SLUG_TAKEN",
  "message": "Der Slug 'mein-artikel' ist bereits vergeben.",
  "field": "slug"
}