Přeskočit na obsah
Ověřeno

Chyby

Co znamená záporný kód a jak se promítá do stavu HTTP, který skutečně vidíte.

Každá metoda odpovídá { code, data }. code > 0 je úspěch. code < 0 je chyba a data je téměř vždy čitelná zpráva, kterou můžete zobrazit nebo zalogovat přímo.

Stav HTTP, který vidíte, není celý příběh

CPI převádí záporný code na stav HTTP jedním pravidlem: kód od -400 do -499 se stane přesně tímto stavem (-404 odpoví HTTP 404, -409 odpoví HTTP 409, -428 odpoví HTTP 428). Každý jiný záporný kód, -1, -500, -762, -999, cokoli mimo toto jedno pásmo, odpoví prostým HTTP 400. Skutečné podrobnosti jsou vždy v těle JSON, proto větvete podle code, nikdy jen podle stavu HTTP. -1 a -999 vypadají na vrstvě HTTP stejně a v těle velmi odlišně.

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

Kódy, podle kterých stojí za to větvit

Kromě této tabulky používají jednotlivé mikroslužby vlastní malé záporné kódy pro stavy specifické pro modul (kódy účtu a fakturace v řádu -90, konflikty Disku kolem -762/-764, kódy databáze kolem -450/-460 a další). Vždy jsou spárovány s popisnou zprávou v data, čtěte tuto zprávu a metodu, kterou jste volali, ne samotné číslo.

Chyby na vrstvě MCP

Požadavek, který selže dřív, než se spustí jakákoli metoda, špatný nebo chybějící klíč, poškozená zpráva MCP, odpoví chybou JSON-RPC místo obálky { code, data }:

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

Viz MCP. Jakmile volání nástroje skutečně dojde k metodě, jeho výsledek nese běžnou obálku { code, data } uvnitř odpovědi MCP, stejně jako prosté volání REST.

Dál