Fehlercodes
Jeder negative Code und HTTP-Status im CPI-Fehlerkatalog, was er bedeutet und was zu tun ist.
Xuda führt einen einzigen Katalog aller Fehler, mit denen ein Aufruf antworten kann. Diese Seite ist dieser Katalog, geordnet danach, wo der Fehler auftaucht. Unter Fehler findest du die API-spezifische Darstellung derselben Codes.
HTTP-Statusfehler
Das sind die Status, die du auf der Transportebene siehst, egal ob du eine Seite direkt aufrufst oder einen
cpi-Aufruf machst.
Client-Vertragscodes
Der Dashboard-Client erkennt diese Codes und steuert anhand von ihnen einen bestimmten UI-Ablauf, statt eine
allgemeine Fehlermeldung zu zeigen. Die Abrechnung wurde von einem Prepaid-Guthaben auf nachträgliche Rechnungsstellung umgestellt, daher sind die einzigen
Sperren bei einer kostenpflichtigen Aktion noch eine fehlende Karte und eine überfällige Rechnung. -92 (negatives Guthaben) und
-93 (Aufladung erforderlich) werden vom Kontoprüfer, der sie früher ausgelöst hat, nicht mehr geworfen. Ein -93-Handler
existiert aus Kompatibilitätsgründen weiterhin im Client, hat aber nichts mehr, was ihn auslöst.
Die Antwort-Hülle
Jede Methode antwortet, bei Erfolg wie bei Fehler, mit { code, data }. code >= 1 bedeutet Erfolg, code < 0 einen
Fehler. Manche Fehler der HTTP-Ebene fügen neben dem numerischen code einen String-Schlüssel error hinzu
("rate_limited", "invalid_fields", "appeal_failed"), manchmal mit einem Array fields: [].
CPI ordnet einen negativen code mit einer Regel einem HTTP-Status zu: Ein Code von -400 bis -499 wird zu
genau diesem Status (-400 selbst antwortet mit HTTP 400, -404 mit HTTP 404, -409 mit HTTP
409, -428 mit HTTP 428). Jeder andere negative Code, -1, -500, -762, -999, alles
außerhalb dieses einen Bereichs, antwortet ebenfalls mit einem schlichten HTTP 400. Ein paar separate, engere Endpunkte (einige
Storefront-Checkout- und Public-Form-Routen, nicht der allgemeine /cpi/<method>-Dispatch) ordnen nur
-404/-403/-400 zu und setzen alles andere stattdessen auf 422. Diese Zuordnung gilt nur lokal für diese Routen
und beschreibt nicht die allgemeine Regel oben. Ein -400 aus dem allgemeinen Dispatch ist also HTTP 400,
nicht 422.
Dieselbe Zahl wird in verschiedenen Methoden mit unterschiedlicher Bedeutung wiederverwendet, vor allem -1 und -400.
Lies immer die data-Meldung und die Methode, die du aufgerufen hast. Die Bedeutungen unten sind der Normalfall,
keine Garantie.
Negative CPI-Codes
Die Codes, bei denen sich eine Verzweigung lohnt, gesammelt aus einem Scan jedes cpi/*_module.
Über diese Tabelle hinaus verwenden einzelne Module kleine negative Codes (grob -2 bis -25,
-44/-45/-46, -64 bis -78, -99/-101/-106) für modulspezifische Zwischenzustände.
Sie sind fast immer mit einer beschreibenden data-Meldung gepaart, oft err.message.
Wenn du auf einen triffst, lies den data-String und die auslösende Methode, statt dich allein
auf die Zahl zu verlassen.
Interne / nicht deklarierte Fehler
Ein paar Fehler erreichen die Hülle { code, data } gar nicht: eine nicht abgefangene Ausnahme, eine
unbehandelte Promise-Ablehnung, ein throw new Error(...), das als nacktes 401 oder 500 erscheint (zum
Beispiel 'app is off', 'Account suspended', 'Account terminated'), oder ein Fehler des Message Brokers.
Sie werden an ihrer Form oder Quelle erkannt statt an einem festen Code, und es lohnt sich immer, sie zu eskalieren,
statt blind zu wiederholen.