Aller au contenu
Vérifié

Erreurs

Ce que signifie un code négatif, et comment il correspond au statut HTTP que vous voyez réellement.

Chaque méthode répond { code, data }. code > 0 signifie succès. code < 0 signifie erreur, et data est presque toujours un message lisible que vous pouvez afficher ou journaliser directement.

Le statut HTTP que vous voyez ne dit pas tout

CPI associe un code négatif à un statut HTTP avec une seule règle : un code de -400 à -499 devient exactement ce statut (-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 un simple HTTP 400. Le vrai détail se trouve toujours dans le corps JSON, donc branchez votre logique sur code, jamais sur le seul statut HTTP. Un -1 et un -999 se ressemblent à la couche HTTP et sont très différents dans le corps.

json
{ "code": -1, "data": "account_not_found" }

Les codes sur lesquels brancher votre logique

Au-delà de ce tableau, certains microservices utilisent leurs propres petits codes négatifs pour des états propres au module (codes de compte et de facturation autour de -90, conflits de Drive autour de -762/-764, codes de base de données autour de -450/-460, et d'autres). Ils sont toujours accompagnés d'un message data descriptif : lisez ce message et la méthode appelée plutôt que le seul nombre.

Erreurs au niveau MCP

Une requête qui échoue avant l'exécution de toute méthode, une clé erronée ou manquante, un message MCP mal formé, répond par une erreur JSON-RPC plutôt que par l'enveloppe { code, data } :

json
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" }, "id": null }

Voir MCP. Quand un appel d'outil atteint réellement une méthode, son résultat porte l'enveloppe normale { code, data } dans la réponse MCP, comme pour un appel REST simple.

La suite