Hoppa till innehållet
Verifierad

Felkoder

Varje negativ kod och HTTP-status i CPI:s felkatalog, vad den betyder och vad du ska göra.

Xuda har en enda katalog över alla fel som ett anrop kan ge tillbaka. Den här sidan är den katalogen, ordnad efter var felet visas. Se Fel för den API-specifika framställningen av samma koder.

HTTP-statusfel

Det här är de statusar du ser på transportnivå, oavsett om du går direkt till en sida eller gör ett cpi-anrop.

Koder i klientkontraktet

Instrumentpanelens egen klient känner igen de här och driver ett särskilt UI-flöde utifrån dem i stället för ett allmänt felmeddelande. Faktureringen gick från ett förbetalt saldo till efterhandsfakturering, så de enda spärrar som finns kvar på en betald åtgärd är ett saknat kort och en förfallen faktura. -92 (negativt saldo) och -93 (påfyllning krävs) är borta från den kontospärr som tidigare kastade dem; en -93-hanterare finns kvar i klienten av kompatibilitetsskäl, den har bara inget kvar som utlöser den.

Svarshöljet

Varje metod, vid framgång eller fel, svarar med { code, data }. code >= 1 är framgång; code < 0 är ett fel. Vissa fel på HTTP-nivå lägger till en strängnyckel error vid sidan av den numeriska code ("rate_limited", "invalid_fields", "appeal_failed"), ibland med en array fields: [].

CPI mappar en negativ code till en HTTP-status med en enda regel: en kod från -400 till -499 blir exakt den statusen (-400 ger själv HTTP 400, -404 ger HTTP 404, -409 ger HTTP 409, -428 ger HTTP 428). Varje annan negativ kod, -1, -500, -762, -999, allt utanför det intervallet, ger också ett vanligt HTTP 400. Några separata, smalare slutpunkter (några kassarutter i butiker och publika formulär, inte den allmänna dispatchen /cpi/<method>) mappar bara -404/-403/-400 och ger i övrigt 422 som standard; den mappningen gäller bara de rutterna och beskriver inte den allmänna regeln ovan, så en -400 från den allmänna dispatchen är HTTP 400, inte 422.

Samma nummer används om och om igen i olika metoder med olika betydelse, särskilt -1 och -400. Läs alltid meddelandet i data och metoden du anropade; betydelserna nedan är det vanliga fallet, inte en garanti.

Negativa CPI-koder

De koder som är värda att förgrena på, hopsamlade från en genomgång av varje cpi/*_module.

Utöver den här tabellen använder enskilda moduler små negativa koder (ungefär -2 till -25, -44/-45/-46, -64 till -78, -99/-101/-106) för modulspecifika mellanlägen. De är nästan alltid kopplade till ett beskrivande meddelande i data, ofta err.message. När du stöter på en, läs strängen i data och den metod som gav den i stället för att förlita dig på numret ensamt.

Interna och odeklarerade fel

Några fel når aldrig höljet { code, data }: ett ofångat undantag, ett ohanterat avvisat löfte, ett throw new Error(...) som visas som ett naket 401 eller 500 (till exempel 'app is off', 'Account suspended', 'Account terminated'), eller ett fel i meddelandebrokern. De upptäcks utifrån form eller källa i stället för en fast kod, och det är alltid värt att eskalera dem i stället för att blint försöka igen.