Kódy chyb
Každý záporný kód a stav HTTP v katalogu chyb CPI, co znamená a co dělat.
Xuda vede jeden katalog všech chyb, s nimiž se může volání vrátit. Tato stránka je ten katalog, uspořádaný podle toho, kde se chyba objeví. Stejné kódy z pohledu API najdete v části Chyby.
Chyby stavu HTTP
Tyto stavy vidíte na transportní vrstvě, ať otevřete stránku přímo, nebo zavoláte
cpi.
Kódy klientského kontraktu
Klient nástěnky tyto kódy rozpozná a podle nich spustí konkrétní tok UI místo obecné chybové
zprávy. Fakturace přešla z předplaceného zůstatku na fakturaci po použití, takže jediné
zbývající brány u placené akce jsou chybějící karta a faktura po splatnosti. -92 (záporný zůstatek) a
-93 (nutné dobití) z brány účtu, která je dříve vyhazovala, zmizely; obsluha -93
v klientovi z důvodu kompatibility stále existuje, jen už nemá, co by ji spustilo.
Obálka odpovědi
Každá metoda, úspěšná i neúspěšná, odpovídá { code, data }. code >= 1 je úspěch; code < 0 je
chyba. Některé chyby vrstvy HTTP přidávají vedle číselného code textový klíč error
("rate_limited", "invalid_fields", "appeal_failed"), někdy s polem fields: [].
CPI mapuje záporný code na stav HTTP jedním pravidlem: kód od -400 do -499 se stane
přesně tímto stavem (-400 odpovídá HTTP 400, -404 odpovídá HTTP 404, -409 odpovídá HTTP
409, -428 odpovídá HTTP 428). Každý jiný záporný kód, -1, -500, -762, -999, cokoli
mimo toto pásmo, odpovídá také prostým HTTP 400. Několik samostatných, užších koncových bodů (některé
trasy pokladny obchodu a veřejných formulářů, ne obecné dispečerské /cpi/<method>) mapuje jen
-404/-403/-400 a vše ostatní nastaví na 422; tato mapa je pro ty trasy lokální
a neplatí pro obecné pravidlo výše, takže -400 z obecného dispečeru je HTTP 400,
ne 422.
Stejné číslo se napříč metodami používá s různým významem, zejména -1 a -400.
Vždy čtěte zprávu v data a metodu, kterou jste volali; významy níže jsou běžný případ,
ne záruka.
Záporné kódy CPI
Kódy, na které stojí za to větvit, sesbírané prohledáním každého cpi/*_module.
Mimo tuto tabulku používají jednotlivé moduly malé záporné kódy (zhruba -2 až -25,
-44/-45/-46, -64 až -78, -99/-101/-106) pro mezistavy specifické pro modul.
Téměř vždy jsou spárovány s popisnou zprávou v data, často err.message.
Když na jeden narazíte, čtěte řetězec data a původní metodu, ne jen číslo.
Interní / nedeklarované chyby
Několik selhání se k obálce { code, data } nikdy nedostane: neodchycená výjimka,
neošetřené odmítnutí promise, throw new Error(...), které se projeví jako holé 401 nebo 500 (například
'app is off', 'Account suspended', 'Account terminated'), nebo selhání brokeru zpráv.
Poznají se podle tvaru nebo zdroje, ne podle pevného kódu, a vždy
stojí za eskalaci, ne za slepé opakování.