Sari la conținut
Verificat

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.