Ugrás a tartalomhoz
Ellenőrizve

Hibakódok

A CPI hibakatalógus minden negatív kódja és HTTP-állapota, mit jelent, és mit kell tenni.

A Xuda egyetlen katalógust vezet minden hibáról, amellyel egy hívás visszatérhet. Ez az oldal ez a katalógus, aszerint rendezve, hogy a hiba hol jelenik meg. Ugyanezeknek a kódoknak az API-specifikus bemutatását lásd az Errors oldalon.

HTTP-állapothibák

Ezeket az állapotokat a szállítási rétegen látja, akár egy oldalt nyit meg közvetlenül, akár egy cpi hívást.

Kliensszerződéses kódok

Az irányítópult saját kliense felismeri ezeket, és általános hibaüzenet helyett egy konkrét felületi folyamatot indít el belőlük. A számlázás előre fizetett egyenlegről utólag fizetett számlázásra váltott, így a fizetős műveleteknél már csak két kapu maradt: a hiányzó kártya és a lejárt számla. A -92 (negatív egyenleg) és a -93 (feltöltés szükséges) eltűnt a fiókkapuból, amely korábban dobta őket; a kliensben még van -93 kezelő a kompatibilitás miatt, csak már nincs, ami kiváltaná.

A válaszborítékok

Minden metódus, sikerrel vagy hibával, { code, data } választ ad. A code >= 1 siker; a code < 0 hiba. Néhány HTTP-rétegbeli hiba a numerikus code mellé egy szöveges error kulcsot is ad ("rate_limited", "invalid_fields", "appeal_failed"), néha egy fields: [] tömbbel.

A CPI egyetlen szabállyal képezi le a negatív code értéket HTTP-állapotra: a -400 és -499 közötti kód pontosan az az állapot lesz (maga a -400 HTTP 400-at ad, a -404 HTTP 404-et, a -409 HTTP 409-et, a -428 HTTP 428-at). Minden más negatív kód, -1, -500, -762, -999, bármi, ami ezen a sávon kívül esik, szintén egyszerű HTTP 400-at ad. Néhány különálló, szűkebb végpont (néhány bolti fizetési és nyilvános űrlap útvonal, nem az általános /cpi/<method> elosztás) csak a -404/-403/-400 kódot képezi le, és minden mást alapértelmezetten 422-re állít; ez a leképezés ezekre az útvonalakra korlátozódik, és nem írja le a fenti általános szabályt, így az általános elosztásból érkező -400 HTTP 400, nem 422.

Ugyanazt a számot a metódusok eltérő jelentéssel használják újra, különösen a -1 és a -400 esetében. Mindig olvassa el a data üzenetet és a hívott metódust; az alábbi jelentések az általános esetet írják le, nem garanciát.

CPI negatív kódok

A figyelemre méltó, elágazásra alkalmas kódok, az összes cpi/*_module átvizsgálásából összegyűjtve.

Ezen a táblázaton túl az egyes modulok kis negatív kódokat (nagyjából -2 és -25 között, -44/-45/-46, -64 és -78 között, -99/-101/-106) használnak modulspecifikus köztes állapotokra. Ezek szinte mindig leíró data üzenettel párosulnak, gyakran err.message értékkel. Ha ilyenbe ütközik, a szám helyett a data szöveget és a kiváltó metódust olvassa el.

Belső / nem deklarált hibák

Néhány hiba sosem jut el a { code, data } borítékig: egy elkapatlan kivétel, egy kezeletlen promise-elutasítás, egy throw new Error(...), amely puszta 401-ként vagy 500-ként jelenik meg (például 'app is off', 'Account suspended', 'Account terminated'), vagy egy üzenetközvetítő hibája. Ezeket alakjuk vagy forrásuk alapján ismerik fel, nem fix kód alapján, és mindig érdemes eszkalálni őket vakon újrapróbálás helyett.