Preskočiť na obsah
Overené

Errors

Čo znamená záporný kód a ako sa premieta do stavu HTTP, ktorý skutočne vidíte.

Každá metóda odpovedá { code, data }. code > 0 je úspech. code < 0 je chyba a data je takmer vždy ľudsky čitateľná správa, ktorú môžete zobraziť alebo zapísať priamo.

Stav HTTP, ktorý vidíte, nie je celý príbeh

CPI premieta záporný code na stav HTTP jedným pravidlom: kód od -400 do -499 sa stane presne týmto stavom (-404 odpovie HTTP 404, -409 odpovie HTTP 409, -428 odpovie HTTP 428). Každý iný záporný kód, -1, -500, -762, -999, čokoľvek mimo tohto jedného pásma, odpovie obyčajným HTTP 400. Skutočný detail je vždy v tele JSON, preto vetvite podľa code, nikdy nie len podľa stavu HTTP. -1 a -999 vyzerajú na vrstve HTTP rovnako a v tele veľmi rozdielne.

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

Kódy, na ktoré sa oplatí vetviť

Mimo tejto tabuľky používajú jednotlivé mikroslužby vlastné malé záporné kódy pre stavy špecifické pre modul (kódy účtu a fakturácie v rozsahu -90, konflikty Drive okolo -762/-764, kódy databázy okolo -450/-460 a ďalšie). Vždy sú spárované s popisnou správou v data, čítajte túto správu a metódu, ktorú ste volali, nie samotné číslo.

Chyby na vrstve MCP

Požiadavka, ktorá zlyhá skôr, než sa spustí akákoľvek metóda, zlý alebo chýbajúci kľúč, poškodená správa MCP, odpovie chybou JSON-RPC namiesto obálky { code, data }:

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

Pozri MCP. Keď volanie nástroja skutočne dosiahne metódu, jeho výsledok nesie bežnú obálku { code, data } vnútri odpovede MCP, rovnako ako obyčajné volanie REST.

Ďalej