Błędy
Co znaczy ujemny kod i jak odpowiada statusowi HTTP, który faktycznie widzisz.
Każda metoda odpowiada { code, data }. code > 0 to sukces, code < 0 to błąd, a data jest
prawie zawsze komunikatem czytelnym dla człowieka, który możesz pokazać lub zalogować bezpośrednio.
Status HTTP, który widzisz, to nie cała historia
CPI zamienia ujemny code na status HTTP jedną regułą: kod od -400 do -499 staje się dokładnie
tym statusem (-404 odpowiada HTTP 404, -409 odpowiada HTTP 409, -428 odpowiada HTTP 428).
Każdy inny kod ujemny, -1, -500, -762, -999, cokolwiek spoza tego jednego pasma, odpowiada
zwykłym HTTP 400. Prawdziwy szczegół zawsze jest w treści JSON, więc rozgałęziaj po code, nigdy
tylko po statusie HTTP. -1 i -999 wyglądają tak samo na warstwie HTTP, a w treści bardzo się różnią.
Kody warte rozgałęziania
Poza tą tabelą poszczególne mikroserwisy używają własnych małych kodów ujemnych dla stanów
specyficznych dla modułu (kody konta i rozliczeń w okolicach -90, konflikty Dysku w okolicach
-762/-764, kody bazy danych w okolicach -450/-460 i inne). Zawsze towarzyszy im opisowy
komunikat w data, czytaj ten komunikat i wywołaną metodę, a nie samą liczbę.
Błędy warstwy MCP
Żądanie, które zawodzi, zanim jakakolwiek metoda się uruchomi, czyli zły lub brakujący klucz albo
zniekształcony komunikat MCP, odpowiada błędem JSON-RPC zamiast kopertą { code, data }:
Zobacz MCP. Gdy wywołanie narzędzia faktycznie dociera do metody, jego wynik niesie
zwykłą kopertę { code, data } wewnątrz odpowiedzi MCP, tak jak zwykłe wywołanie REST.