Przejdź do treści
Zweryfikowano

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ą.

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

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

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

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.

Dalej