Hoppa till innehållet
Verifierad

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.

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

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

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

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.

Nästa