Coduri de eroare
Catalogul tuturor erorilor cu care poate reveni un apel, organizat după locul în care apare eroarea.
Xuda păstrează un singur catalog cu fiecare eroare cu care poate reveni un apel. Această pagină este acel catalog, organizat după locul în care apare eroarea. Vezi Erori pentru încadrarea acelorași coduri specifică API-ului.
Erori de stare HTTP
Acestea sunt stările pe care le vezi la nivelul de transport, fie că accesezi direct o pagină, fie
un apel cpi.
Coduri de contract cu clientul
Clientul propriu al tabloului de bord le recunoaște și declanșează din ele un flux de UI anume, în
loc de un mesaj de eroare generic. Facturarea a trecut de la un sold preplătit la facturare
postplătită, așa că singurele bariere rămase la o acțiune plătită sunt lipsa unui card și o factură
restantă. -92 (sold negativ) și -93 (alimentare necesară) au dispărut din bariera de cont care
le arunca; un handler pentru -93 mai există în client pentru compatibilitate, doar că nu mai are
nimic care să îl declanșeze.
Plicul de răspuns
Fiecare metodă, cu succes sau cu eroare, răspunde cu { code, data }. code >= 1 înseamnă succes;
code < 0 înseamnă eroare. Unele erori de nivel HTTP adaugă o cheie error de tip șir lângă
code-ul numeric ("rate_limited", "invalid_fields", "appeal_failed"), uneori cu un șir
fields: [].
CPI mapează un code negativ la o stare HTTP după o singură regulă: un cod de la -400 la -499
devine exact acea stare (-400 răspunde chiar cu HTTP 400, -404 cu HTTP 404, -409 cu HTTP 409,
-428 cu HTTP 428). Orice alt cod negativ, -1, -500, -762, -999, orice se află în afara
acelei benzi, răspunde tot cu un simplu HTTP 400. Câteva endpointuri separate și mai înguste (unele
rute de checkout din magazin și de formulare publice, nu dispecerul general /cpi/<method>)
mapează doar -404/-403/-400 și pun tot restul pe 422; acea hartă este locală acelor rute și nu
descrie regula generală de mai sus, așa că un -400 din dispecerul general este HTTP 400, nu 422.
Același număr este refolosit în metode diferite cu sensuri diferite, mai ales -1 și -400. Citește
întotdeauna mesajul din data și metoda pe care ai apelat-o; sensurile de mai jos sunt cazul
obișnuit, nu o garanție.
Coduri negative CPI
Codurile pe care merită să le folosești la ramificare, adunate dintr-o scanare a fiecărui
cpi/*_module.
Pe lângă acest tabel, modulele individuale folosesc coduri negative mici (aproximativ de la -2 la
-25, -44/-45/-46, de la -64 la -78, -99/-101/-106) pentru stări intermediare
specifice modulului. Acestea sunt aproape întotdeauna însoțite de un mesaj descriptiv în data, adesea
err.message. Când dai de unul, citește șirul din data și metoda de origine, nu te baza doar pe
număr.
Erori interne / nedeclarate
Câteva eșecuri nu ajung deloc în plicul { code, data }: o excepție neprinsă, o respingere de promise
netratată, un throw new Error(...) care apare ca un simplu 401 sau 500 (de exemplu 'app is off',
'Account suspended', 'Account terminated') sau un eșec al brokerului de mesaje. Acestea sunt
detectate după formă sau sursă, nu după un cod fix, și merită întotdeauna escaladate, nu reîncercate
orbește.