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