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.
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:
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.