Hopp til innholdet
Bekreftet

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.

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

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:

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

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.

Neste