Fehler

Die Fehlerhülle

Jeder Fehler — Validierung, Auth, Ratenbegrenzung oder Server — kommt in einer einheitlichen Form zurück. Verzweigen Sie über den maschinenlesbaren code und zeigen Sie message für Menschen an:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request body is invalid",
    "details": [ /* optional, strukturiert — siehe unten */ ]
  }
}

Der HTTP-Status trägt weiterhin Bedeutung (401 nicht authentifiziert, 403 verboten, 404 nicht gefunden, 422 nicht verarbeitbar, 429 ratenbegrenzt, 5xx Serverfehler), aber code ist der stabile Wert, über den verzweigt wird — Meldungen können umformuliert werden. Die vollständige Liste finden Sie in der Fehlercodes-Referenz.

Validierungsdetails

Ein 422-Validierungsfehler enthält ein details-Array. Jeder Eintrag ist auf path, code und message normalisiert, sodass Sie Fehler unabhängig von der Validator-Version auf das betroffene Feld zurückführen können:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request body is invalid",
    "details": [
      { "path": "name", "code": "too_small", "message": "String must contain at least 1 character(s)" },
      { "path": "attributes.netWeight", "code": "invalid_type", "message": "Expected number, received string" }
    ]
  }
}

Request-IDs

Jede Antwort trägt einen X-Request-ID-Header. Protokollieren Sie ihn und geben Sie ihn beim Kontakt mit dem Support an — er erlaubt es uns, eine einzelne Anfrage End-to-End durch die Plattform zu verfolgen.