Kódy chýb
Každý záporný kód a stav HTTP v katalógu chýb CPI, čo znamená a čo robiť.
Xuda vedie jeden katalóg všetkých chýb, s ktorými sa môže volanie vrátiť. Táto stránka je ten katalóg, usporiadaný podľa toho, kde sa chyba zobrazí. Rámec rovnakých kódov špecifický pre API nájdete v časti Errors.
HTTP status errors
Toto sú stavy, ktoré vidíte na transportnej vrstve, či už otvoríte stránku priamo, alebo
zavoláte cpi.
Client-contract codes
Vlastný klient dashboardu tieto kódy rozpoznáva a podľa nich spustí konkrétny postup v UI namiesto
všeobecnej chybovej správy. Fakturácia prešla z prepaid zostatku na faktúry po použití, takže
jediné brány, ktoré na platenej akcii zostali, sú chýbajúca karta a faktúra po splatnosti. -92
(záporný zostatok) a -93 (potrebné dobitie) z brány účtu, ktorá ich vyhadzovala, zmizli; obsluha
-93 v klientovi z dôvodov kompatibility stále existuje, len už nemá čo ju spustí.
The response envelope
Každá metóda, úspešná aj neúspešná, odpovie { code, data }. code >= 1 je úspech; code < 0 je
chyba. Niektoré chyby na vrstve HTTP pridávajú popri číselnom code aj textový kľúč error
("rate_limited", "invalid_fields", "appeal_failed"), niekedy s poľom fields: [].
CPI mapuje záporný code na stav HTTP jedným pravidlom: kód od -400 do -499 sa stane presne
týmto stavom (samotné -400 odpovie HTTP 400, -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, tiež odpovie obyčajným HTTP 400. Niekoľko samostatných, užších koncových
bodov (niekoľko ciest pokladne obchodu a verejných formulárov, nie všeobecné rozdeľovanie
/cpi/<method>) mapuje iba -404/-403/-400 a všetko ostatné namiesto toho predvolene mapuje
na 422; táto mapa je lokálna pre tie cesty a neopisuje všeobecné pravidlo vyššie, takže -400 zo
všeobecného rozdeľovania je HTTP 400, nie 422.
To isté číslo sa v rôznych metódach používa s rôznym významom, najmä -1 a -400. Vždy čítajte
správu v data a metódu, ktorú ste zavolali; významy nižšie sú bežný prípad, nie záruka.
CPI negative codes
Kódy, pri ktorých sa oplatí vetviť, zhromaždené skenovaním každého cpi/*_module.
Mimo tejto tabuľky jednotlivé moduly používajú malé záporné kódy (zhruba -2 až -25,
-44/-45/-46, -64 až -78, -99/-101/-106) pre medzistavy špecifické pre modul.
Takmer vždy sú spárované s popisnou správou v data, často err.message. Keď na jeden narazíte,
prečítajte reťazec data a pôvodnú metódu, nespoliehajte sa len na číslo.
Internal / undeclared errors
Niekoľko zlyhaní sa k obálke { code, data } nedostane vôbec: neodchytená výnimka, neobslúžené
odmietnutie promisu, throw new Error(...), ktorý sa prejaví ako holé 401 alebo 500 (napríklad
'app is off', 'Account suspended', 'Account terminated'), alebo zlyhanie sprostredkovateľa
správ. Rozpoznávajú sa podľa tvaru alebo zdroja, nie podľa pevného kódu, a vždy stojí za to ich
eskalovať a neopakovať naslepo.