Gå til indhold
Bekræftet

Fejl

Hvad en negativ code betyder, og hvordan den svarer til den HTTP-status, du faktisk ser.

Hver metode svarer { code, data }. code > 0 er succes. code < 0 er en fejl, og data er næsten altid en læsbar besked, du kan vise eller logge direkte.

Den HTTP-status, du ser, er ikke hele historien

CPI oversætter en negativ code til en HTTP-status med én regel: en kode fra -400 til -499 bliver præcis den status (-404 giver HTTP 404, -409 giver HTTP 409, -428 giver HTTP 428). Enhver anden negativ kode, -1, -500, -762, -999, alt uden for det ene bånd, giver en almindelig HTTP 400. De egentlige detaljer står altid i JSON-kroppen, så forgren på code, aldrig kun på HTTP-statussen. Et -1 og et -999 ser ens ud på HTTP-laget og meget forskellige ud i kroppen.

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

Koder, det er værd at forgrene på

Ud over denne tabel bruger de enkelte mikrotjenester deres egne små negative koder til modulspecifikke tilstande (konto- og faktureringskoder i -90'erne, Drive-konflikter omkring -762/-764, databasekoder omkring -450/-460 og flere). De er altid parret med en beskrivende data-besked. Læs den besked og den metode, du kaldte, i stedet for tallet alene.

Fejl på MCP-laget

En anmodning, der fejler, før nogen metode kører, en forkert eller manglende nøgle, en forkert udformet MCP-besked, besvares med en JSON-RPC-fejl 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 værktøjskald faktisk når en metode, bærer dets resultat den normale { code, data }-konvolut inde i MCP-svaret, ligesom et almindeligt REST-kald.

Næste