Saltar al contenido
Verificada

Errores

Qué significa un código negativo y cómo se corresponde con el estado HTTP que ves realmente.

Cada método responde { code, data }. code > 0 es éxito. code < 0 es un error, y data es casi siempre un mensaje legible que puedes mostrar o registrar directamente.

El estado HTTP que ves no es toda la historia

CPI convierte un code negativo en un estado HTTP con una sola regla: un código de -400 a -499 se convierte en ese mismo estado (-404 responde HTTP 404, -409 responde HTTP 409, -428 responde HTTP 428). Cualquier otro código negativo, -1, -500, -762, -999, cualquiera fuera de esa banda, responde un HTTP 400 normal. El detalle real siempre está en el cuerpo JSON, así que ramifica según code, nunca solo según el estado HTTP. Un -1 y un -999 se ven idénticos en la capa HTTP y muy distintos en el cuerpo.

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

Códigos que conviene ramificar

Más allá de esta tabla, cada microservicio usa sus propios códigos negativos pequeños para estados específicos del módulo (códigos de cuenta y facturación en los -90, conflictos de Drive en torno a -762/-764, códigos de base de datos en torno a -450/-460, y más). Siempre van acompañados de un mensaje data descriptivo; lee ese mensaje y el método al que llamaste en lugar de fijarte solo en el número.

Errores de la capa MCP

Una solicitud que falla antes de que se ejecute ningún método, una clave incorrecta o ausente, un mensaje MCP mal formado, responde con un error JSON-RPC en lugar del sobre { code, data }:

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

Consulta MCP. Cuando una llamada a una herramienta llega realmente a un método, su resultado lleva el sobre { code, data } normal dentro de la respuesta MCP, igual que una llamada REST normal.

Siguiente