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