Zum Inhalt springen
Geprüft

Fehler

Was ein negativer Code bedeutet und wie er auf den HTTP-Status abgebildet wird, den du tatsächlich siehst.

Jede Methode antwortet mit { code, data }. code > 0 ist Erfolg. code < 0 ist ein Fehler, und data ist fast immer eine lesbare Meldung, die du direkt anzeigen oder protokollieren kannst.

Der HTTP-Status, den du siehst, ist nicht die ganze Geschichte

CPI bildet einen negativen code mit einer einzigen Regel auf einen HTTP-Status ab: Ein Code von -400 bis -499 wird zu genau diesem Status (-404 antwortet mit HTTP 404, -409 mit HTTP 409, -428 mit HTTP 428). Jeder andere negative Code, -1, -500, -762, -999, alles außerhalb dieses einen Bereichs, antwortet mit einem einfachen HTTP 400. Das eigentliche Detail steht immer im JSON-Body, also verzweige nach code, nie allein nach dem HTTP-Status. Ein -1 und ein -999 sehen auf der HTTP-Ebene gleich aus und im Body sehr verschieden.

json
{ "code": -1, "data": "account_not_found" }

Codes, nach denen sich zu verzweigen lohnt

Über diese Tabelle hinaus nutzen einzelne Microservices eigene kleine negative Codes für modulspezifische Zustände (Konto- und Abrechnungscodes im Bereich der -90er, Drive-Konflikte um -762/-764, Datenbankcodes um -450/-460 und mehr). Sie sind immer mit einer beschreibenden data-Meldung gepaart: Lies diese Meldung und die aufgerufene Methode, nicht allein die Zahl.

Fehler auf der MCP-Ebene

Eine Anfrage, die scheitert, bevor eine Methode läuft, ein falscher oder fehlender Schlüssel, eine fehlerhafte MCP-Nachricht, wird mit einem JSON-RPC-Fehler statt mit der Hülle { code, data } beantwortet:

json
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" }, "id": null }

Siehe MCP. Sobald ein Tool-Aufruf tatsächlich eine Methode erreicht, trägt sein Ergebnis die normale Hülle { code, data } innerhalb der MCP-Antwort, genau wie bei einem einfachen REST-Aufruf.

Als Nächstes