Los límites de tasa controlan el número de solicitudes que puedes hacer a los puntos finales dentro de una ventana de tiempo específica. Estos límites ayudan a garantizar la estabilidad del servicio y protegen los recursos de Roblox contra abusos.
Descubrimiento
Hay dos formas de determinar los límites de tasa: la documentación de referencia y los encabezados de respuesta.
Páginas de documentación
Los límites de tasa públicos se pueden encontrar en la sección Límites de cada punto final en sus páginas de documentación. Consulta estas secciones para entender los límites de tasa que se aplican antes de hacer solicitudes.
Nos esforzamos por ser lo más transparentes posible sobre los límites de tasa, pero pueden aplicarse límites adicionales no documentados, incluyendo para la protección contra DDoS y la estabilidad del servicio. Asegúrate de que tu aplicación maneje las respuestas de límite de tasa HTTP 429. Consulta Manejo de límites de tasa para obtener orientación.
Si alcanzas un límite de tasa no documentado que bloquea tu caso de uso (o si deseas límites más altos para un punto final), por favor deja comentarios explicando tus necesidades en el Foro de Desarrolladores.
Encabezados de respuesta
Muchas respuestas de API incluyen encabezados que proporcionan información sobre el estado actual de tu límite de tasa.
| Encabezado | Descripción |
|---|---|
| x-ratelimit-limit | El número total de solicitudes permitidas dentro de la ventana de límite de tasa. Esto puede incluir múltiples valores de límite para diferentes ventanas de tiempo. |
| x-ratelimit-remaining | El número de solicitudes que aún puedes hacer con tu autenticación actual. Cuando esto llega a 0, recibes respuestas HTTP 429. |
| x-ratelimit-reset | El número de segundos restantes hasta que tu cuota de límite de tasa se restaure al límite total. |
Aquí hay un ejemplo de encabezados de límite de tasa en una respuesta de API:
En este ejemplo:
- Te quedan 998 solicitudes de tu límite total.
- Tu cuota se restablecerá en 20 segundos.
Comportamiento
El comportamiento de los límites de tasa difiere según el método de autenticación y el origen de la solicitud, incluyendo si realizas solicitudes desde dentro de un juego de Roblox.
Clave API
Los límites de tasa para las claves API se aplican a todas las claves API por propietario, que puede ser un usuario o un grupo. Estos límites se aplican de manera consistente sin importar de dónde provengan las solicitudes, ya sean de HttpService, aplicaciones web u otras fuentes.
En el juego con HttpService
Al llamar a puntos finales en el juego usando HttpService, las solicitudes también contribuyen al límite fijo de 500 solicitudes HTTP por minuto por servidor de juego de Roblox. Consulta Solicitudes HTTP en el juego para más detalles.
OAuth 2.0
Los límites de tasa de OAuth 2.0 se aplican por token de acceso. Dado que cada token de acceso representa una combinación única de usuario y aplicación, cada usuario que utiliza tu aplicación recibe su propia cuota de límite de tasa independiente.
Manejo de límites de tasa
Escribe tu código para esperar y manejar respuestas HTTP 429 (Demasiadas Solicitudes) debido a límites documentados, prevención de abusos o escenarios de alta carga. Cuando estés limitado por la tasa, verifica el encabezado de respuesta retry-after como una guía sobre cuándo reintentar. Si no hay un encabezado de respuesta retry-after presente, implementa una estrategia de reintento de retroceso exponencial.