Saltar al contenido
Restoman Guía

Errores y límites

Qué responde Restoman cuando no puede: los errores de su API, de OAuth, del MCP y de los agentes, y sus límites.

Toda respuesta trae X-Request-Id, y todo error es JSON. Ese id es lo que hay que mandar a soporte si algo falla.

La API

Un error de la API es { "type", "code", "requestId" }: type dice la clase (unauthorized, forbidden, not_found, validation, rate_limited, unavailable…) y code, cuando lo hay, el motivo exacto. Un 429 trae Retry-After y retryAfter en segundos.

OAuth

El servidor de autorización responde los errores de OAuth (RFC 6749): { "error", "error_description" }, como invalid_grant o invalid_request. Su límite por dirección responde 429 con { "code": "RATE_LIMITED", "message", "retryAfter" } y Retry-After.

El MCP de Restoman

Respuesta Qué significa
401 con WWW-Authenticate Sin token, o vencido o revocado: volvé a OAuth
403 con insufficient_scope Al token le falta el permiso de esa herramienta: la persona vuelve a conectar
Un resultado con isError y un código El rol de la persona o el estado del negocio no lo permiten (MISSING_PERMISSION, LOCATION_NOT_ASSIGNED, CEILING_…)
429 con Retry-After Más de 120 llamadas por minuto o 2.000 por hora, por persona y agente
JSON-RPC -32602 Argumentos que no son los de la herramienta

Un error de una herramienta hay que decirlo como es y mandar a la persona al panel: nunca buscar otro camino.

Los MCP y agentes públicos

  • Un POST de más de 16 KB responde 413, y un Origin de otro sitio, 403.
  • JSON-RPC: -32700 es un JSON que no se entiende, -32600 un mensaje que no es JSON-RPC 2.0, -32601 un método que no existe y -32602 argumentos equivocados.
  • Un slug o una guía que no existen responden un resultado con isError, no un error del protocolo.
  • Los agentes A2A responden los códigos de A2A: -32001 para una tarea (no guardan ninguna), -32003 para avisos push, -32004 para transmitir, -32005 para archivos, -32007 para la tarjeta extendida y -32009 para una versión que no hablan.

Todas las guías