Errores

​

Errores HTTP

Nuestra API sigue un formato predecible de códigos de error HTTP:

• 400 - invalid_request_error: Hubo un problema con el formato o contenido de tu solicitud. También podemos usar este tipo de error para otros códigos de estado 4XX no listados a continuación.
• 401 - authentication_error: Hay un problema con tu clave de API.
• 403 - permission_error: Tu clave de API no tiene permiso para usar el recurso especificado.
• 404 - not_found_error: No se encontró el recurso solicitado.
• 429 - rate_limit_error: Tu cuenta ha alcanzado un límite de velocidad.
• 500 - api_error: Ha ocurrido un error inesperado interno en los sistemas de Anthropic.
• 529 - overloaded_error: La API de Anthropic está temporalmente sobrecargada.

Al recibir una respuesta de streaming a través de SSE, es posible que ocurra un error después de devolver una respuesta 200, en cuyo caso el manejo de errores no seguiría estos mecanismos estándar.

​

Formas de errores

Los errores siempre se devuelven como JSON, con un objeto error de nivel superior que siempre incluye un valor type y message. Por ejemplo:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "No se pudo encontrar el recurso solicitado."
  }
}

De acuerdo con nuestra política de versioning, podemos expandir los valores dentro de estos objetos, y es posible que los valores de type crezcan con el tiempo.