Přeskočit na obsah
Ověřeno

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