Ir al contenido

Límite de solicitudes

Cómo limita la API de BoxHero la frecuencia de solicitudes por equipo y cómo esperar y reintentar.


Para mantener el servicio estable para todos, la API de BoxHero limita cuántas solicitudes puede enviar un equipo.

Todos los tokens de API de un mismo equipo comparten los mismos límites. Generar más tokens en un equipo no aumenta el límite. Los límites por segundo y por minuto se aplican a la vez, y los encabezados de la respuesta informan el límite por minuto.

La API responde con 429 y un objeto de error cuyo type es /errors/too-many-requests. Los encabezados de la respuesta indican cuándo puede volver a intentarlo:

EncabezadoDescripción
Retry-AfterSegundos que debe esperar antes de reintentar
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetEl límite actual, las solicitudes restantes y cuándo se restablece el límite

Espere el tiempo indicado en Retry-After y vuelva a intentarlo. Si envía muchas solicitudes seguidas, distribúyalas en lugar de enviarlas todas a la vez.

Si las solicitudes de una misma dirección IP fallan repetidamente en la autenticación (más de 30 veces en 60 segundos), las solicitudes posteriores de esa IP reciben 429 sin importar el token que se utilice.