Przejdź do treści
Zweryfikowano

Kody błędów

Każdy ujemny kod i status HTTP z katalogu błędów CPI, co oznacza i co zrobić.

Xuda trzyma jeden katalog każdego błędu, z którym może wrócić wywołanie. Ta strona jest tym katalogiem, uporządkowanym według miejsca, w którym błąd się pojawia. Zobacz Błędy, żeby poznać ujęcie tych samych kodów z perspektywy API.

Błędy statusu HTTP

To statusy widoczne w warstwie transportu, niezależnie od tego, czy otwierasz stronę bezpośrednio, czy wywołujesz cpi.

Kody kontraktu klienta

Własny klient pulpitu rozpoznaje te kody i na ich podstawie uruchamia konkretny przepływ UI zamiast ogólnego komunikatu o błędzie. Rozliczenia przeszły z salda przedpłaconego na fakturowanie z płatnością z dołu, więc jedyne bramki, które zostały przy płatnej akcji, to brak karty i przeterminowana faktura. -92 (ujemne saldo) i -93 (wymagane doładowanie) zniknęły z bramki konta, która kiedyś je zgłaszała; w kliencie nadal istnieje procedura obsługi -93 dla zgodności, tylko nie ma już niczego, co mogłoby ją wywołać.

Koperta odpowiedzi

Każda metoda, udana czy nie, odpowiada { code, data }. code >= 1 to sukces; code < 0 to błąd. Niektóre błędy warstwy HTTP dodają obok liczbowego code tekstowy klucz error ("rate_limited", "invalid_fields", "appeal_failed"), czasem z tablicą fields: [].

CPI mapuje ujemny code na status HTTP jedną regułą: kod od -400 do -499 staje się dokładnie tym statusem (-400 odpowiada HTTP 400, -404 odpowiada HTTP 404, -409 odpowiada HTTP 409, -428 odpowiada HTTP 428). Każdy inny ujemny kod, -1, -500, -762, -999, cokolwiek poza tym jednym pasmem, odpowiada też zwykłym HTTP 400. Garstka osobnych, węższych punktów końcowych (kilka tras kasy sklepu i formularzy publicznych, nie ogólne wywołanie /cpi/<method>) mapuje tylko -404/-403/-400, a wszystko inne domyślnie na 422; ta mapa jest lokalna dla tych tras i nie opisuje ogólnej reguły powyżej, więc -400 z ogólnego wywołania to HTTP 400, nie 422.

Ta sama liczba jest używana w różnych metodach z różnym znaczeniem, zwłaszcza -1 i -400. Zawsze czytaj komunikat w data i metodę, którą wywołałeś; poniższe znaczenia to typowy przypadek, nie gwarancja.

Ujemne kody CPI

Kody, na które warto się rozgałęziać, zebrane ze skanu każdego cpi/*_module.

Poza tą tabelą poszczególne moduły używają małych ujemnych kodów (mniej więcej od -2 do -25, -44/-45/-46, od -64 do -78, -99/-101/-106) dla stanów pośrednich specyficznych dla modułu. Prawie zawsze towarzyszy im opisowy komunikat w data, często err.message. Gdy na jakiś trafisz, przeczytaj ciąg w data i metodę źródłową, zamiast polegać tylko na liczbie.

Błędy wewnętrzne / niezadeklarowane

Garstka awarii w ogóle nie trafia do koperty { code, data }: nieprzechwycony wyjątek, nieobsłużone odrzucenie obietnicy, throw new Error(...), który wychodzi jako goły 401 lub 500 (na przykład 'app is off', 'Account suspended', 'Account terminated'), albo awaria brokera wiadomości. Wykrywa się je po kształcie lub źródle, a nie po stałym kodzie, i zawsze lepiej je eskalować, niż ponawiać na ślepo.