Gå til indhold
Bekræftet

Fejlkoder

Hver negativ kode og HTTP-status i CPI's fejlkatalog, hvad den betyder, og hvad du skal gøre.

Xuda har ét katalog over alle de fejl, et kald kan komme tilbage med. Denne side er det katalog, ordnet efter, hvor fejlen vises. Se Fejl for den API-specifikke indramning af de samme koder.

HTTP-statusfejl

Det er de statusser, du ser på transportlaget, uanset om du rammer en side direkte eller et cpi-kald.

Koder i klientkontrakten

Dashboardets egen klient genkender disse og styrer et bestemt UI-forløb ud fra dem i stedet for en generisk fejlbesked. Fakturering er gået fra en forudbetalt saldo til efterfølgende fakturering, så de eneste spærringer, der er tilbage på en betalt handling, er et manglende kort og en forfalden faktura. -92 (negativ saldo) og -93 (optankning kræves) er væk fra kontospærringen, der tidligere kastede dem; en -93-handler findes stadig i klienten af hensyn til kompatibilitet, den har bare ikke noget tilbage, der udløser den.

Svarkonvolutten

Hver metode, uanset om den lykkes eller fejler, svarer { code, data }. code >= 1 er succes; code < 0 er en fejl. Nogle fejl på HTTP-laget tilføjer en streng-nøgle error ved siden af den numeriske code ("rate_limited", "invalid_fields", "appeal_failed"), nogle gange med et fields: []-array.

CPI oversætter en negativ code til en HTTP-status med én regel: en kode fra -400 til -499 bliver til præcis den status (-400 selv svarer HTTP 400, -404 svarer HTTP 404, -409 svarer HTTP 409, -428 svarer HTTP 428). Enhver anden negativ kode, -1, -500, -762, -999, alt uden for det ene bånd, svarer også blot HTTP 400. Nogle få separate, snævrere endpoints (nogle storefront-checkout- og offentlige formularruter, ikke den generelle /cpi/<method>-dispatch) oversætter kun -404/-403/-400 og sætter alt andet til 422; det kort gælder kun for de ruter og beskriver ikke den generelle regel ovenfor, så en -400 fra den generelle dispatch er HTTP 400, ikke 422.

Det samme tal bruges på tværs af metoder med forskellig betydning, især -1 og -400. Læs altid data-beskeden og den metode, du kaldte; betydningerne nedenfor er det almindelige tilfælde, ikke en garanti.

CPI's negative koder

De koder, det er værd at forgrene på, samlet ud fra en gennemgang af hvert cpi/*_module.

Ud over denne tabel bruger de enkelte moduler små negative koder (cirka -2 til -25, -44/-45/-46, -64 til -78, -99/-101/-106) til modulspecifikke mellemtilstande. De er næsten altid parret med en beskrivende data-besked, ofte err.message. Når du rammer en, så læs data-strengen og den metode, den kom fra, i stedet for kun at stole på tallet.

Interne / ikke-deklarerede fejl

Nogle få fejl når slet ikke frem til { code, data }-konvolutten: en uopfanget undtagelse, en uhåndteret promise-afvisning, en throw new Error(...), der viser sig som en bar 401 eller 500 (for eksempel 'app is off', 'Account suspended', 'Account terminated'), eller en fejl i message-brokeren. De opdages ud fra form eller kilde i stedet for en fast kode, og de er altid værd at eskalere i stedet for at prøve blindt igen.