Fel
Vad en negativ kod betyder, och hur den motsvarar den HTTP-status du faktiskt ser.
Varje metod svarar { code, data }. code > 0 är framgång. code < 0 är ett fel, och data är
nästan alltid ett läsbart meddelande som du kan visa eller logga direkt.
HTTP-statusen du ser är inte hela bilden
CPI översätter en negativ code till en HTTP-status med en enda regel: en kod från -400 till
-499 blir exakt den statusen (-404 ger HTTP 404, -409 ger HTTP 409, -428 ger HTTP 428).
Varje annan negativ kod, -1, -500, -762, -999, allt utanför det bandet, ger ett vanligt
HTTP 400. Den verkliga informationen finns alltid i JSON-kroppen, så förgrena på code, aldrig
enbart på HTTP-statusen. En -1 och en -999 ser likadana ut på HTTP-nivå och mycket olika ut i
kroppen.
Koder värda att förgrena på
Utöver den här tabellen använder enskilda mikrotjänster egna små negativa koder för modulspecifika
tillstånd (konto- och faktureringskoder i -90-serien, Drive-konflikter runt -762/-764,
databaskoder runt -450/-460 och fler). De kommer alltid med ett beskrivande data-meddelande,
läs det meddelandet och metoden du anropade i stället för enbart numret.
Fel på MCP-nivå
En förfrågan som misslyckas innan någon metod körs, en felaktig eller saknad nyckel eller ett
felformaterat MCP-meddelande, besvaras med ett JSON-RPC-fel i stället för formatet { code, data }:
Se MCP. När ett verktygsanrop väl når en metod har dess resultat det vanliga formatet
{ code, data } inuti MCP-svaret, precis som ett vanligt REST-anrop.