DocumentaciónAPI y MCP

Errores y límites

Los códigos de error, qué significan y cuántas llamadas por minuto.

Un error responde { "error": { "code": "…", "message": "…" } } con su estado HTTP. Por MCP, el mensaje del error de herramienta es CODE: message. Decide según el código, no según el mensaje.

Códigos de error

EstadoCódigoCuándo
400INVALID_INPUTEl cuerpo o un argumento no encaja con la operación: details lista los campos que fallan.
401MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETEDNo hay clave, la clave es desconocida o está revocada, ha caducado, o su espacio se ha eliminado.
402INSUFFICIENT_TOKENSUna operación de pago que los créditos del espacio no pueden cubrir.
403FORBIDDENEl creador de la clave no tiene permiso para hacer esto en el espacio: la misma regla que en la aplicación.
403PLAN_LIMIT_EXCEEDEDEl plan del espacio no lo incluye: en una cuenta que nunca ha pagado, los enlaces entrantes de un competidor o el análisis de un competidor oculto.
404NOT_FOUNDNo existe ese sitio, esa conversación, esa tarea… en este espacio.
409CONFLICTYa está en curso, o en un estado que no lo permite.
429RATE_LIMITEDDemasiadas peticiones para el espacio: Retry-After indica cuándo volver a intentarlo.
503SERVICE_UNAVAILABLEUn servicio que necesita la operación no está disponible por un momento: vuelve a intentarlo más tarde.
500INTERNAL_ERROREs culpa nuestra: vuelve a intentarlo más tarde.
402
{
  "error": {
    "code": "INSUFFICIENT_TOKENS",
    "message": "Workspace is out of tokens for this period."
  }
}

Límites de uso

Por espacio
API120 peticiones por minuto
MCP30 llamadas a herramientas por minuto

Por encima del límite, la respuesta es 429 RATE_LIMITED, con una cabecera Retry-After que indica cuándo volver a intentarlo.

¿No encuentras la respuesta? Escríbenos.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos