> ## Índice de la documentación
> Consulta el índice completo de la documentación en: https://developer.rhombus.com/llms.txt
> Úsalo para descubrir todas las páginas disponibles antes de seguir explorando.

# Límites de tasa

> Comprende los límites de tasa de la API de Rhombus y crea integraciones resilientes que manejen respuestas 429 limitadas con retroceso exponencial y lógica de reintento.

> **Note**: Esta página se tradujo automáticamente. Si encuentras errores o tienes sugerencias, [escríbenos](mailto:support@rhombus.com).

Las solicitudes a la API REST cuentan para un límite de tasa cuando se hacen con cualquiera de estas credenciales:

- [Claves de API](https://developer.rhombus.com/es/authentication/api-keys), incluidas las claves de ejecutables y de chatbots
- [Credenciales de partner](https://developer.rhombus.com/es/partner-api-calls): claves de partner, certificados y tokens de acceso OAuth de partner
- [Tokens de acceso OAuth](https://developer.rhombus.com/es/oauth-authentication)
- [Tokens federados](https://developer.rhombus.com/es/authentication/federated-tokens)

El límite es **por organización**: todas estas credenciales que actúan en tu organización comparten un único presupuesto, con los mismos límites, así que crear más credenciales no lo aumenta. Las solicitudes de una credencial de partner cuentan para la organización cliente indicada en `x-auth-org`, o para la organización partner si falta ese encabezado.

## Cómo funcionan los límites

Rhombus usa un algoritmo de **token bucket** (cubo de tokens). Dos valores rigen tu rendimiento:

- Una **tasa de recarga sostenida** (solicitudes por segundo): tu límite máximo en estado estable.
- Una **capacidad de ráfaga**, aproximadamente 10× la tasa de recarga de forma predeterminada: margen que absorbe picos cortos.

Las ráfagas tienen éxito de inmediato mientras el cubo tiene tokens. Una vez que el cubo se vacía, el tráfico sostenido por encima de la tasa de recarga devuelve `429` hasta que el cubo se vuelve a llenar.

Las tasas predeterminadas se aplican a todas las organizaciones, y los mismos límites aplican tanto en la región de EE. UU. como en la de la UE ([regiones](https://developer.rhombus.com/es/api-regions)) — se aplican dentro de la región de tu organización. Para solicitar un límite más alto, contacta al [soporte de Rhombus](mailto:support@rhombus.com).

## Respuestas limitadas

Dos tipos de límite responden con `429 Too Many Requests` y un encabezado `Retry-After`, el número de segundos que debes esperar (al menos 1):

| Límite                                                                                                        | Se aplica a                                                       | Cuerpo                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Límite de tasa de la organización                                                                             | Cada solicitud REST hecha con una de las credenciales anteriores  | El [cuerpo de error](https://developer.rhombus.com/es/errors#el-sobre-de-la-respuesta) JSON con `"errorCode": "RATE_LIMITED"` |
| [Límites por cámara](https://developer.rhombus.com/es/rate-limits#límites-por-cámara-para-clips-y-fotogramas) | Crear clips y obtener fotogramas exactos, desde cualquier cliente | JSON con `"error": true` y un `errorMsg` que nombra las cámaras                                                               |

```text Límite de la organización
HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{"error":true,"errorCode":"RATE_LIMITED","errorMsg":"…","status":429,"txid":"…", …}
```

```text Límite por cámara
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

{"error":true,"errorMsg":"Clip creation is temporarily throttled for device(s) [AAAAAAAAAAAAAAAAAAAAAA]; retry after 12 second(s)"}
```

Para el límite de la organización, `Retry-After` se calcula a partir de la tasa de recarga de tu organización. Decide según el código de estado o `errorCode`, y espera los segundos de `Retry-After`.

> **Warning**: **No** reintentes de inmediato ante un `429`. Las solicitudes repetidas mientras estás limitado siguen siendo rechazadas y no reinician tu ventana de límite.

## Límites por cámara para clips y fotogramas

La creación de clips ([`spliceV3`](https://developer.rhombus.com/api-reference/video-webservice/splice-v3) y los anteriores `splice` y `spliceV2`) y los fotogramas exactos ([`getExactFrameUri`](https://developer.rhombus.com/api-reference/video-webservice/get-exact-frame-uri), [`getExactFrameData`](https://developer.rhombus.com/api-reference/video-webservice/get-exact-frame-data) y [`getLiveImage`](https://developer.rhombus.com/api-reference/video-webservice/get-live-image)) también tienen un límite por cámara, independiente del límite de tu organización y compartido por todo lo que usa esa cámara, incluida la consola:

- Cada cámara admite una ráfaga de solicitudes y después una tasa sostenida más lenta.
- Un rechazo inicia un periodo de espera, y las solicitudes durante ese periodo también se rechazan. Los rechazos posteriores a ese periodo alargan la siguiente espera, así que reintentar antes de tiempo solo te retrasa.
- Una solicitud que incluye varias cámaras se rechaza completa si cualquiera de ellas supera su límite, y `Retry-After` es la espera más larga.

Para exportar o muestrear mucho video, reparte las solicitudes entre cámaras y a lo largo del tiempo en lugar de enviarlas seguidas para una sola cámara.

## Registro de clientes OAuth

El registro dinámico anónimo de clientes (`POST /oauth/register`) tiene sus propios límites: 10 registros por hora desde una misma dirección IP de cliente y 100 por hora en total. Por encima de cualquiera de los dos, el registro responde `429` con `Retry-After` y un cuerpo de error de OAuth, donde `error` es la cadena `temporarily_unavailable`. Consulta [Iniciar sesión con Rhombus](https://developer.rhombus.com/es/oauth-authentication).

## Manejo de los límites de tasa

1. **Lee el encabezado Retry-After**

   El encabezado `Retry-After` te indica exactamente cuántos segundos debes esperar, calculado a partir de la tasa de recarga de tu organización. Prefiere siempre este valor en lugar de retrasos codificados.

2. **Pausa las solicitudes**

   Deja de enviar solicitudes durante el tiempo especificado en el encabezado.

3. **Reintenta tu solicitud**

   Después del periodo de espera, reintenta la solicitud original.

## Estrategia de reintento

Espera los segundos de `Retry-After` ante un `429` y, ante errores temporales del servidor, espera de forma exponencial con jitter completo:

```text Espera
espera = aleatorio(0, min(espera_máxima, espera_base × 2^intento))
```

| Parámetro        | Valor recomendado                          |
| ---------------- | ------------------------------------------ |
| Espera base      | 1 segundo                                  |
| Espera máxima    | 60 segundos                                |
| Intentos máximos | Unos 5, dentro de un presupuesto de tiempo |

[Errores: reintentos y espera exponencial](https://developer.rhombus.com/es/errors#reintentos-y-espera-exponencial) tiene un cliente en Python y JavaScript que aplica estas reglas y explica qué respuestas no reintentar.

## Cuándo reintentar

Reintenta los `429`, las respuestas `5xx` y los fallos de red; no reintentes otras respuestas `4xx` ni las respuestas `200` con `"error": true`. [Errores](https://developer.rhombus.com/es/errors#reintentos-y-espera-exponencial) explica cada caso.

## Throttling de notificaciones de alertas

Las notificaciones de alertas (distintas de los límites de tasa de la API) tienen un **intervalo mínimo** configurable entre alertas consecutivas del mismo tipo para un dispositivo dado. Esto evita la fatiga por alertas debida a eventos de alta frecuencia como la detección de movimiento.

| Intervalo                      | Segundos |
| ------------------------------ | -------- |
| 1 minuto                       | 60       |
| 2 minutos                      | 120      |
| **5 minutos (predeterminado)** | 300      |
| 10 minutos                     | 600      |
| 20 minutos                     | 1200     |
| 30 minutos                     | 1800     |
| 1 hora                         | 3600     |

Configura esto por política y por tipo de actividad. Durante la ventana de retroceso, las alertas duplicadas para el mismo dispositivo y tipo de actividad se suprimen del lado del servidor.

> **Tip**: Las alertas con **nueva información de identidad** —como un rostro reconocido distinto o una placa de matrícula— omiten el retroceso y se entregan de inmediato, incluso dentro de la ventana de supresión.