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.
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 } :
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.