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