Vai al contenuto
Verificata

Errori

Cosa significa un codice negativo e come si traduce nello stato HTTP che vedi davvero.

Ogni metodo risponde { code, data }. code > 0 è successo. code < 0 è un errore e data è quasi sempre un messaggio leggibile che puoi mostrare o registrare direttamente.

Lo stato HTTP che vedi non è tutta la storia

CPI traduce un code negativo in uno stato HTTP con una sola regola: un codice da -400 a -499 diventa esattamente quello stato (-404 risponde HTTP 404, -409 risponde HTTP 409, -428 risponde HTTP 428). Ogni altro codice negativo, -1, -500, -762, -999, qualsiasi cosa fuori da quella fascia, risponde con un semplice HTTP 400. Il dettaglio reale sta sempre nel corpo JSON, quindi ramifica su code, mai solo sullo stato HTTP. Un -1 e un -999 sembrano identici a livello HTTP e molto diversi nel corpo.

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

Codici su cui vale la pena ramificare

Oltre a questa tabella, i singoli microservizi usano i propri piccoli codici negativi per stati specifici del modulo (codici di account e fatturazione nei -90, conflitti di Drive intorno a -762/-764, codici del database intorno a -450/-460 e altri). Sono sempre abbinati a un messaggio data descrittivo: leggi quel messaggio e il metodo che hai chiamato, non solo il numero.

Errori a livello MCP

Una richiesta che fallisce prima che venga eseguito qualsiasi metodo, una chiave errata o mancante, un messaggio MCP malformato, risponde con un errore JSON-RPC invece del formato { code, data }:

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

Vedi MCP. Quando una chiamata di strumento raggiunge davvero un metodo, il suo risultato porta il normale formato { code, data } dentro la risposta MCP, come una normale chiamata REST.

Passi successivi