Feil
Hva en negativ kode betyr, og hvordan den kobles til HTTP-statusen du faktisk ser.
Hver metode svarer { code, data }. code > 0 er suksess. code < 0 er en feil, og data er
nesten alltid en menneskelesbar melding du kan vise eller logge direkte.
HTTP-statusen du ser, er ikke hele historien
CPI kobler en negativ code til en HTTP-status med én regel: en kode fra -400 til -499 blir
nøyaktig den statusen (-404 gir HTTP 404, -409 gir HTTP 409, -428 gir HTTP 428). Alle
andre negative koder, -1, -500, -762, -999, alt utenfor det ene båndet, gir en vanlig
HTTP 400. Den virkelige detaljen ligger alltid i JSON-kroppen, så forgren på code, aldri på
HTTP-statusen alene. En -1 og en -999 ser identiske ut i HTTP-laget og svært ulike ut i kroppen.
Koder det er verdt å forgrene på
Utover denne tabellen bruker enkelte mikrotjenester sine egne små negative koder for modulspesifikke
tilstander (konto- og faktureringskoder i -90-området, Drive-konflikter rundt -762/-764,
databasekoder rundt -450/-460, og mer). De er alltid koblet til en beskrivende data-melding,
les den meldingen og metoden du kalte i stedet for tallet alene.
Feil i MCP-laget
En forespørsel som feiler før noen metode kjører, en ugyldig eller manglende nøkkel, en feilformet
MCP-melding, svarer en JSON-RPC-feil i stedet for { code, data }-konvolutten:
Se MCP. Når et verktøykall først når en metode, har resultatet den vanlige
{ code, data }-konvolutten inne i MCP-svaret, på samme måte som et vanlig REST-kall.