Fehler & Response-Envelope

Jede Antwort — Erfolg oder Fehler — verwendet dieselbe Envelope-Struktur, sodass Sie sie jedes Mal auf die gleiche Weise parsen können.

{
  "error_code": 0,
  "message": "Success",
  "errors": null,
  "data": { }
}

Im Fehlerfall

Im Fehlerfall enthält error_code einen symbolischen Code wie WRONG_QUERY, data ist null und errors kann Validierungsdetails auf Feldebene enthalten. Der HTTP-Status spiegelt die Fehlerklasse wider (4xx Client, 5xx Server), während der Code die konkrete Ursache benennt — siehe die vollständige Fehlercode-Referenz.