Codici di errore
Ogni codice negativo e stato HTTP del catalogo errori di CPI, cosa significa e cosa fare.
Xuda tiene un unico catalogo di tutti gli errori con cui può tornare una chiamata. Questa pagina è quel catalogo, organizzato in base a dove compare l'errore. Vedi Errori per l'impostazione specifica per l'API degli stessi codici.
Errori di stato HTTP
Sono gli stati che vedi a livello di trasporto, sia che apri direttamente una pagina sia che fai
una chiamata cpi.
Codici del contratto client
Il client della dashboard riconosce questi codici e, invece di un messaggio di errore generico, ne
fa partire un flusso UI specifico. La fatturazione è passata dal saldo prepagato alla fatturazione
posticipata, quindi gli unici blocchi rimasti su un'azione a pagamento sono una carta mancante e
una fattura scaduta. -92 (saldo negativo) e -93 (ricarica richiesta) non vengono più generati
dal controllo dell'account che li lanciava; nel client esiste ancora un gestore per -93, per
compatibilità, ma non ha più nulla che lo attivi.
La busta di risposta
Ogni metodo, in caso di successo o di errore, risponde { code, data }. code >= 1 indica
successo; code < 0 indica un errore. Alcuni errori del livello HTTP aggiungono una chiave
stringa error accanto al code numerico ("rate_limited", "invalid_fields",
"appeal_failed"), a volte con un array fields: [].
CPI mappa un code negativo a uno stato HTTP con una sola regola: un codice da -400 a -499
diventa esattamente quello stato (-400 stesso risponde HTTP 400, -404 risponde HTTP 404, -409
risponde HTTP 409, -428 risponde HTTP 428). Ogni altro codice negativo, -1, -500, -762,
-999, qualsiasi cosa fuori da quella fascia, risponde a sua volta con un semplice HTTP 400.
Alcuni endpoint separati e più ristretti (poche route di checkout dello store e di moduli
pubblici, non il dispatch generale /cpi/<method>) mappano solo -404/-403/-400 e per tutto
il resto usano 422; quella mappa è locale a quelle route e non descrive la regola generale qui
sopra, quindi un -400 dal dispatch generale è HTTP 400, non 422.
Lo stesso numero viene riutilizzato in metodi diversi con significati diversi, soprattutto -1 e
-400. Leggi sempre il messaggio in data e il metodo che hai chiamato; i significati qui sotto
sono il caso comune, non una garanzia.
Codici negativi di CPI
I codici su cui vale la pena fare dei rami nel codice, raccolti da una scansione di ogni
cpi/*_module.
Oltre a questa tabella, i singoli moduli usano piccoli codici negativi (circa da -2 a -25,
-44/-45/-46, da -64 a -78, -99/-101/-106) per stati intermedi specifici del modulo.
Quasi sempre sono accompagnati da un messaggio descrittivo in data, spesso err.message. Quando
ne incontri uno, leggi la stringa in data e il metodo di origine invece di fidarti del solo
numero.
Errori interni / non dichiarati
Alcuni errori non arrivano mai nella busta { code, data }: un'eccezione non gestita, un rifiuto
di promise non gestito, un throw new Error(...) che compare come un semplice 401 o 500 (per
esempio 'app is off', 'Account suspended', 'Account terminated'), oppure un errore del
message broker. Si riconoscono dalla forma o dall'origine e non da un codice fisso, e vale sempre
la pena segnalarli invece di riprovare alla cieca.