Saltar para o conteúdo
Verificado

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.

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

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

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

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.

Seguinte