Erros
O que significa um código negativo e como corresponde ao estado HTTP que realmente vê.
Todos os métodos respondem { code, data }. code > 0 é sucesso. code < 0 é um erro, e data é
quase sempre uma mensagem legível que pode mostrar ou registar diretamente.
O estado HTTP que vê não é a história toda
O CPI converte um code negativo num estado HTTP com uma só regra: um código de -400 a -499 torna-se
exatamente esse estado (-404 responde HTTP 404, -409 responde HTTP 409, -428 responde HTTP 428).
Todos os outros códigos negativos, -1, -500, -762, -999, qualquer um fora dessa faixa, respondem
um simples HTTP 400. O verdadeiro detalhe está sempre no corpo JSON, por isso ramifique por code, nunca apenas pelo
estado HTTP. Um -1 e um -999 parecem idênticos na camada HTTP e muito diferentes no
corpo.
Códigos em que vale a pena ramificar
Além desta tabela, os microserviços individuais utilizam os seus próprios pequenos códigos negativos para estados específicos de cada módulo
(códigos de conta e faturação na casa dos -90, conflitos do Drive à volta de -762/-764, códigos
de base de dados à volta de -450/-460, e mais). Vêm sempre associados a uma mensagem data descritiva;
leia essa mensagem e o método que chamou, em vez de apenas o número.
Erros da camada MCP
Um pedido que falha antes de qualquer método correr, uma chave inválida ou em falta, uma mensagem MCP mal formada,
responde com um erro JSON-RPC em vez do envelope { code, data }:
Consulte MCP. Quando uma chamada de ferramenta chega de facto a um método, o seu resultado traz o envelope normal
{ code, data } dentro da resposta MCP, tal como uma chamada REST simples.