Límites de solicitudes

Visión General

Para proteger el sistema de la academia contra problemas de rendimiento durante el uso normal de EVO, las APIs siguen un sistema de rate limits (limitación de solicitudes). Estas restricciones garantizan que el entorno permanezca estable, incluso bajo una alta carga de uso.

Los criterios de rate limits se describen a continuación:

Criterios de Límite de Solicitudes

1. Límite por Segundo (por IP)

Límite: 5 solicitudes por segundo para la misma IP.

Comportamiento después de alcanzar el límite:

Retorno con código de estado 429 (Too Many Requests).

Esperar 1 segundo antes de realizar nuevas solicitudes.

2. Límite por Minuto (por IP)

Límite: 40 solicitudes por minuto para la misma IP.

Comportamiento después de alcanzar el límite:

Retorno con código de estado 429 (Too Many Requests).

Esperar 1 minuto antes de realizar nuevas solicitudes.

💎 Clientes de API Pro no tienen el límite por minuto.

3. Límite por Hora (por Clave de API)

Límite: 10.000 solicitudes por hora para la misma clave de API.

Comportamiento después de alcanzar el límite:

La clave de API quedará bloqueada por 1 hora.

Retorno con código de estado 429 (Too Many Requests).

Detalles:

El bloqueo se aplica a la clave específica, independientemente de la IP que realizó las solicitudes.

Todas las solicitudes realizadas con esta clave cuentan para el límite.

4. Rate Limit por Hora (por DNS de la Academia)

Límite: 20.000 solicitudes por hora para el mismo DNS de la academia.

Comportamiento después de alcanzar el límite:

Todas las claves vinculadas al DNS de la academia quedarán bloqueadas por 1 hora.

Retorno con código de estado 429 (Too Many Requests).

Detalles:

El bloqueo se aplica a la academia (validado por el DNS), independientemente de la IP o de la clave de API utilizada.

Todas las solicitudes realizadas por la academia cuentan para el límite.

Ventana de Exención de Límites

Horario: De 0h a 5h.

Durante este período, no se aplican límites en cuanto a la cantidad de solicitudes por hora, por DNS o por IP. Sin embargo, los límites de solicitudes por segundo y por minuto permanecen activos. Es decir, es posible realizar solicitudes en mayor volumen sin que estos límites se apliquen, pero aún estarán vigentes las restricciones de cantidad de solicitudes por segundo y por minuto.

Solicitudes en lote pueden realizarse durante este período.

Operaciones que requieran un alto volumen de solicitudes pueden aprovechar esta ventana.

Resumen de los Límites

Tipo de Límite	Límite	Bloqueo	Código de Estado
Por Segundo (por IP)	5 solicitudes	por 1s	429
Por Minuto (por IP)	40 solicitudes	por 1m	429
Por Hora (por Clave)	10.000 solicitudes	por 1h	429
Por Hora (por DNS)	20.000 solicitudes	por 1h	429

Buenas Prácticas para Evitar Rate Limits

Implementa un sistema de retry (reintento) con backoff: Al recibir un código de estado 429, espera antes de intentar nuevamente.

Evita solicitudes innecesarias: Asegúrate de que solo se realicen las solicitudes esenciales.

Aprovecha la ventana de exención: Programa solicitudes en lote entre 0h y 5h, cuando los límites por hora, DNS e IP no se aplican, pero presta atención a los límites de solicitudes por segundo.

Monitorea tus solicitudes: Utiliza logs para seguir y ajustar el volumen de llamadas a la API.

Límites de solicitudes

Visión General#

Criterios de Límite de Solicitudes#

1. Límite por Segundo (por IP)#

2. Límite por Minuto (por IP)#

3. Límite por Hora (por Clave de API)#

4. Rate Limit por Hora (por DNS de la Academia)#

Ventana de Exención de Límites#

Resumen de los Límites#

Buenas Prácticas para Evitar Rate Limits#

Visión General

Criterios de Límite de Solicitudes

1. Límite por Segundo (por IP)

2. Límite por Minuto (por IP)

3. Límite por Hora (por Clave de API)

4. Rate Limit por Hora (por DNS de la Academia)

Ventana de Exención de Límites

Resumen de los Límites

Buenas Prácticas para Evitar Rate Limits