> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores y límites de tasa

> Respuestas de error comunes de la API de Fetch Hive, códigos de estado y comportamiento de concurrencia de flujos de trabajo

# Errores y límites de tasa

Fetch Hive devuelve errores en JSON para solicitudes inválidas o fallidas a la API pública. Los errores de runtime de la API pública incluyen un `message` legible para humanos, un código estable y `error` como alias de compatibilidad.

## Formato de la respuesta de error

```json theme={null}
{
  "error": "Invalid access.",
  "message": "Invalid access.",
  "error_code": "validation_error"
}
```

Algunas respuestas de plan y de límite de tasa también incluyen `code` para compatibilidad con clientes existentes. Los nuevos clientes deben leer `error_code`. Consulta [Códigos de error](./error-codes) para ver la lista completa de códigos, el endpoint del catálogo y la guía para el manejo desde el cliente.

## Códigos de estado comunes

### `401 Unauthorized`

Fetch Hive devuelve `401` cuando el encabezado `Authorization` está ausente, es inválido o usa una clave de API revocada.

Ejemplo:

```json theme={null}
{
  "error": "Invalid access."
}
```

### `404 Not Found`

Fetch Hive devuelve `404` cuando el recurso no existe para tu cuenta.

Respuesta de ejemplo para una ejecución de flujo de trabajo:

```json theme={null}
{
  "error": "Prompt workflow run not found"
}
```

Respuesta de ejemplo para una búsqueda de solicitud:

```json theme={null}
{
  "error": "Request not found"
}
```

### `422 Unprocessable Entity`

Fetch Hive devuelve `422` cuando la solicitud está autenticada pero es inválida para ese endpoint.

Ejemplos:

```json theme={null}
{
  "error": "Agent not found."
}
```

```json theme={null}
{
  "error": "Data set not found."
}
```

```json theme={null}
{
  "error": "You've reached your credit cap."
}
```

### `502 Bad Gateway`

Fetch Hive devuelve `502` cuando un proveedor falla al procesar una solicitud de prompt o agente.

Ejemplo:

```json theme={null}
{
  "error": "openai API error: provider rejected the request"
}
```

## Límites de tasa y concurrencia

Las solicitudes a la API pública cuentan contra el tope diario de llamadas a la API de tu plan. Si excedes ese tope, Fetch Hive devuelve `429 Too Many Requests` antes de ejecutar la solicitud.

Respuesta de ejemplo para el tope diario de la API:

```json theme={null}
{
  "error": "Daily API rate limit reached",
  "code": "api_rate_limit_exceeded",
  "message": "You have reached your daily limit of 50 API calls. Resets at midnight UTC. Upgrade your plan for higher limits.",
  "limit": 50,
  "current": 50
}
```

La concurrencia de flujos de trabajo depende de tu plan.

| Plan       | Tope de concurrencia |
| ---------- | -------------------- |
| Lite       | 1                    |
| Starter    | 3                    |
| Pro        | 5                    |
| Entreprise | Personalizado        |

Si excedes tu tope de concurrencia, Fetch Hive devuelve `429 Too Many Requests`.

Ejemplo:

```json theme={null}
{
  "error": "You've reached your concurrency limit. Try again later or use async mode."
}
```

Si ves esta respuesta en una solicitud de flujo de trabajo, reintenta más tarde o cambia a entrega por callback para que Fetch Hive pueda encolar la ejecución.

## Relacionado

* Consulta [Autenticación](./authentication) para el encabezado bearer requerido
* Consulta [Códigos de error](./error-codes) para los valores estables de `error_code` y `GET /v1/error_codes`
* Consulta [Invocar flujo de trabajo](./workflows/invoke) para solicitudes de flujo de trabajo con entrega por callback