Aller au contenu
Vérifié

Codes d'erreur

Chaque code négatif et chaque statut HTTP du catalogue d'erreurs CPI, leur signification et la marche à suivre.

Xuda tient un seul catalogue de toutes les erreurs qu'un appel peut renvoyer. Cette page est ce catalogue, organisé selon l'endroit où l'erreur apparaît. Consultez Erreurs pour la présentation des mêmes codes côté API.

Erreurs de statut HTTP

Ce sont les statuts que vous voyez au niveau du transport, que vous accédiez directement à une page ou à un appel cpi.

Codes du contrat client

Le client du tableau de bord reconnaît ces codes et déclenche un parcours d'interface précis plutôt qu'un message d'erreur générique. La facturation est passée d'un solde prépayé à une facturation postpayée : les seules barrières restantes sur une action payante sont l'absence de carte et une facture en retard. -92 (solde négatif) et -93 (recharge requise) ont disparu de la barrière du compte qui les levait ; un gestionnaire de -93 existe encore dans le client par compatibilité, il n'a simplement plus rien pour le déclencher.

L'enveloppe de réponse

Chaque méthode, en cas de succès comme d'échec, répond { code, data }. code >= 1 signifie succès ; code < 0 signifie erreur. Certaines erreurs de la couche HTTP ajoutent une clé error de type chaîne à côté du code numérique ("rate_limited", "invalid_fields", "appeal_failed"), parfois avec un tableau fields: [].

CPI associe un code négatif à un statut HTTP selon une seule règle : un code de -400 à -499 devient ce statut exact (-400 répond HTTP 400, -404 répond HTTP 404, -409 répond HTTP 409, -428 répond HTTP 428). Tout autre code négatif, -1, -500, -762, -999, tout ce qui sort de cette plage, répond lui aussi HTTP 400. Quelques points d'accès distincts et plus restreints (quelques routes de paiement en boutique et de formulaire public, pas le dispatch général /cpi/<method>) n'associent que -404/-403/-400 et renvoient 422 pour tout le reste ; cette association est propre à ces routes et ne décrit pas la règle générale ci-dessus : un -400 issu du dispatch général est donc un HTTP 400, pas un 422.

Le même nombre est réutilisé par plusieurs méthodes avec des sens différents, surtout -1 et -400. Lisez toujours le message de data et la méthode que vous avez appelée ; les significations ci-dessous correspondent au cas courant, sans garantie.

Codes négatifs CPI

Les codes sur lesquels il vaut la peine de brancher une logique, issus d'un balayage de chaque cpi/*_module.

En dehors de ce tableau, certains modules utilisent de petits codes négatifs (environ -2 à -25, -44/-45/-46, -64 à -78, -99/-101/-106) pour des états intermédiaires propres au module. Ils sont presque toujours accompagnés d'un message descriptif dans data, souvent err.message. Quand vous en rencontrez un, lisez la chaîne de data et la méthode d'origine plutôt que de vous fier au seul nombre.

Erreurs internes ou non déclarées

Quelques échecs n'atteignent jamais l'enveloppe { code, data } : une exception non interceptée, un rejet de promesse non géré, un throw new Error(...) qui apparaît sous la forme d'un simple 401 ou 500 (par exemple 'app is off', 'Account suspended', 'Account terminated'), ou un échec du broker de messages. On les reconnaît à leur forme ou à leur source plutôt qu'à un code fixe, et il vaut toujours mieux les escalader que de réessayer à l'aveugle.