Vai al contenuto
Verificata

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.