Feilkoder
Hver negative kode og HTTP-status i CPI-feilkatalogen, hva den betyr og hva du bør gjøre.
Xuda har én katalog over alle feil et kall kan gi tilbake. Denne siden er den katalogen, ordnet etter hvor feilen dukker opp. Se Feil for den API-spesifikke innrammingen av de samme kodene.
HTTP-statusfeil
Dette er statusene du ser på transportlaget, enten du åpner en side direkte eller gjør et
cpi-kall.
Koder for klientkontrakten
Oversiktspanelets egen klient gjenkjenner disse og starter en bestemt UI-flyt ut fra dem i stedet
for å vise en generisk feilmelding. Faktureringen gikk fra en forhåndsbetalt saldo til
etterskuddsvis fakturering, så de eneste sperrene som er igjen på en betalt handling er et manglende
kort og en forfalt faktura. -92 (negativ saldo) og -93 (påfylling kreves) er borte fra
kontosperren som tidligere kastet dem. En -93-behandler finnes fortsatt i klienten av
kompatibilitetshensyn, den har bare ingenting igjen som utløser den.
Svarkonvolutten
Hver metode, enten det lykkes eller ikke, svarer { code, data }. code >= 1 er suksess, code < 0
er en feil. Noen feil på HTTP-laget legger til en tekstnøkkel error ved siden av den numeriske
code ("rate_limited", "invalid_fields", "appeal_failed"), noen ganger med en fields: []-liste.
CPI kartlegger en negativ code til en HTTP-status med én regel: en kode fra -400 til -499 blir
nøyaktig den statusen (-400 gir selv HTTP 400, -404 gir HTTP 404, -409 gir HTTP 409, -428
gir HTTP 428). Alle andre negative koder, -1, -500, -762, -999, alt utenfor det ene
båndet, gir også en vanlig HTTP 400. Noen få separate, smalere endepunkter (noen ruter for
betaling i nettbutikk og offentlige skjemaer, ikke den generelle /cpi/<method>-fordelingen)
kartlegger bare -404/-403/-400 og bruker 422 som standard for alt annet. Det kartet gjelder
bare de rutene og beskriver ikke den generelle regelen over, så en -400 fra den generelle
fordelingen er HTTP 400, ikke 422.
Det samme tallet brukes på tvers av metoder med ulik betydning, særlig -1 og -400. Les alltid
data-meldingen og metoden du kalte. Betydningene nedenfor er det vanlige tilfellet, ikke en
garanti.
Negative CPI-koder
Kodene det er verdt å forgrene på, samlet fra en gjennomgang av alle cpi/*_module.
Utover denne tabellen bruker enkelte moduler små negative koder (omtrent -2 til -25,
-44/-45/-46, -64 til -78, -99/-101/-106) for modulspesifikke mellomtilstander. De er
nesten alltid knyttet til en beskrivende data-melding, ofte err.message. Når du treffer en, les
data-teksten og metoden den kom fra i stedet for å stole på tallet alene.
Interne / ikke-deklarerte feil
Noen få feil når aldri { code, data }-konvolutten: et uoppfanget unntak, et ubehandlet
promise-avslag, en throw new Error(...) som vises som en bar 401 eller 500 (for eksempel
'app is off', 'Account suspended', 'Account terminated'), eller en feil i meldingsmegleren. De
oppdages ut fra form eller kilde i stedet for en fast kode, og det er alltid verdt å eskalere dem i
stedet for å prøve på nytt i blinde.