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