Les limites de cadence contrôlent le nombre de requêtes que vous pouvez faire aux points de terminaison dans une fenêtre de temps spécifique. Ces limites aident à garantir la stabilité du service et à protéger les ressources Roblox contre les abus.
Découverte
Il existe deux façons de déterminer les limites de cadence : la documentation de référence et les en-têtes de réponse.
Pages de documentation
Les limites de cadence publiques peuvent être trouvées dans la section Limites de chaque point de terminaison sur leurs pages de documentation. Consultez ces sections pour comprendre les limites de cadence qui s'appliquent avant de faire des requêtes.
Nous nous efforçons d'être aussi transparents que possible sur les limites de cadence, mais des limites additionnelles, non documentées, peuvent s'appliquer, y compris pour la protection DDoS et la stabilité du service. Assurez-vous toujours que votre application gère les réponses de limite de cadence HTTP 429. Voir Gestion des limites de cadence pour des conseils.
Si vous rencontrez une limite de cadence non documentée qui bloque votre cas d'utilisation (ou si vous souhaitez des limites plus élevées pour un point de terminaison), veuillez laisser un commentaire expliquant vos besoins dans le Forum des développeurs.
En-têtes de réponse
De nombreuses réponses API incluent des en-têtes qui fournissent des informations sur votre statut de limite de cadence actuel.
| En-tête | Description |
|---|---|
| x-ratelimit-limit | Le nombre total de requêtes autorisées dans la fenêtre de limite de cadence. Cela peut inclure plusieurs valeurs limites pour différentes fenêtres temporelles. |
| x-ratelimit-remaining | Le nombre de requêtes que vous pouvez encore faire avec votre authentification actuelle. Lorsque cela atteint 0, vous recevez des réponses HTTP 429. |
| x-ratelimit-reset | Le nombre de secondes restantes avant que votre quota de limite de cadence ne soit réinitialisé à la limite maximale. |
Voici un exemple d'en-têtes de limite de cadence dans une réponse API :
Dans cet exemple :
- Vous avez 998 requêtes restantes sur votre limite totale.
- Votre quota sera réinitialisé dans 20 secondes.
Comportement
Le comportement de la limite de cadence varie selon la méthode d'authentification et l'origine de la requête, y compris si vous faites des requêtes depuis un jeu Roblox.
Clé API
Les limites de cadence pour les clés API s'appliquent à toutes les clés API par propriétaire, qui peut être soit un utilisateur, soit un groupe. Ces limites sont appliquées de manière cohérente, quel que soit l'endroit d'où proviennent les requêtes—que ce soit depuis HttpService, des applications web ou d'autres sources.
Dans le jeu avec HttpService
Lors de l'appel des points de terminaison dans le jeu en utilisant HttpService, les requêtes contribuent également à la limite fixe de 500 requêtes HTTP par minute par serveur de jeu Roblox. Voir Requêtes HTTP en jeu pour plus de détails.
OAuth 2.0
Les limites de cadence OAuth 2.0 sont appliquées par jeton d'accès. Puisque chaque jeton d'accès représente une combinaison unique d'utilisateur et d'application, chaque utilisateur utilisant votre application reçoit son propre quota de limite de cadence indépendant.
Gestion des limites de cadence
Écrivez votre code pour prévoir et gérer les réponses HTTP 429 (Trop de requêtes) dues aux limites documentées, à la prévention des abus ou à des scénarios de forte charge. Lorsque vous êtes limité, consultez l'en-tête de réponse retry-after comme indication du moment où réessayer. S'il n'y a pas d'en-tête de réponse retry-after présent, mettez en œuvre une stratégie de réessai avec un retour exponentiel.