Preskočiť na obsah
Overené

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.