Virhekoodit
Jokainen CPI-virhekatalogin negatiivinen koodi ja HTTP-tila, mitä se tarkoittaa ja mitä tehdä.
Xuda pitää yhtä luetteloa kaikista virheistä, jotka kutsu voi palauttaa. Tämä sivu on se luettelo, järjestettynä sen mukaan, missä virhe näkyy. Katso Virheet, miten samat koodit on kehystetty API-käyttöön.
HTTP-tilavirheet
Nämä ovat tilat, jotka näet siirtokerroksella, kutsuitpa sivua suoraan tai cpi-kutsulla.
Asiakassopimuksen koodit
Koontinäytön oma asiakas tunnistaa nämä ja käynnistää niistä tietyn käyttöliittymäkulun yleisen virheviestin sijaan. Laskutus siirtyi ennakkosaldosta jälkikäteen laskutettaviin laskuihin, joten maksullisen toiminnon ainoat jäljellä olevat esteet ovat puuttuva kortti ja erääntynyt lasku. -92 (negatiivinen saldo) ja -93 (lataus vaaditaan) on poistettu tilin portista, joka ne aiemmin heitti; -93-käsittelijä on yhä asiakkaassa yhteensopivuuden vuoksi, mutta mikään ei enää laukaise sitä.
Vastausvaippa
Jokainen metodi, onnistuipa se tai ei, vastaa { code, data }. code >= 1 on onnistuminen; code < 0 on virhe. Jotkin HTTP-kerroksen virheet lisäävät numeerisen code-kentän viereen merkkijonoisen error-avaimen ("rate_limited", "invalid_fields", "appeal_failed"), joskus fields: []-taulukon kanssa.
CPI kartoittaa negatiivisen code-arvon HTTP-tilaksi yhdellä säännöllä: koodi väliltä -400...-499 muuttuu täsmälleen kyseiseksi tilaksi (-400 itse vastaa HTTP 400, -404 vastaa HTTP 404, -409 vastaa HTTP 409, -428 vastaa HTTP 428). Jokainen muu negatiivinen koodi, -1, -500, -762, -999, mikä tahansa tuon yhden alueen ulkopuolella, vastaa myös pelkkää HTTP 400:aa. Muutama erillinen, kapeampi päätepiste (muutama kaupan kassan ja julkisen lomakkeen reitti, ei yleinen /cpi/<method>-jakelu) kartoittaa vain -404/-403/-400 ja käyttää oletuksena kaikelle muulle 422:ta; kartta on paikallinen näille reiteille eikä kuvaa yllä olevaa yleistä sääntöä, joten -400 yleisestä jakelusta on HTTP 400, ei 422.
Sama numero on käytössä usealla metodilla eri merkityksillä, erityisesti -1 ja -400. Lue aina data-viesti ja kutsumasi metodi; alla olevat merkitykset ovat yleisin tapaus, eivät takuu.
CPI:n negatiiviset koodit
Koodit, joiden mukaan kannattaa haarautua, koottuna jokaisen cpi/*_module-moduulin läpikäynnistä.
Tämän taulukon lisäksi yksittäiset moduulit käyttävät pieniä negatiivisia koodeja (karkeasti -2...-25, -44/-45/-46, -64...-78, -99/-101/-106) moduulikohtaisiin välitiloihin. Ne esiintyvät lähes aina kuvailevan data-viestin kanssa, usein err.message. Kun törmäät sellaiseen, lue data-merkkijono ja lähtömetodi äläkä luota pelkkään numeroon.
Sisäiset / ilmoittamattomat virheet
Muutama virhe ei koskaan pääse { code, data }-vaippaan: käsittelemätön poikkeus, käsittelemätön promise-hylkäys, throw new Error(...), joka näkyy pelkkänä 401:nä tai 500:na (esimerkiksi 'app is off', 'Account suspended', 'Account terminated'), tai viestinvälittäjän virhe. Ne tunnistetaan muodosta tai lähteestä eikä kiinteästä koodista, ja ne kannattaa aina eskaloida sokean uudelleenyrityksen sijaan.