Limites de taxa controlam o número de solicitações que você pode fazer aos pontos finais dentro de uma janela de tempo específica. Esses limites ajudam a garantir a estabilidade do serviço e proteger os recursos do Roblox contra abusos.
Descoberta
Existem duas maneiras de determinar os limites de taxa: a documentação de referência e os cabeçalhos de resposta.
Páginas de documentação
Limites de taxa públicos podem ser encontrados na seção Limites para cada ponto final em suas páginas de documentação. Veja essas seções para entender os limites de taxa que se aplicam antes de fazer solicitações.
Nos esforçamos para ser o mais transparentes possível sobre os limites de taxa, mas limites adicionais, não documentados, podem se aplicar, incluindo para proteção DDoS e estabilidade do serviço. Sempre assegure-se de que seu aplicativo gerencia as respostas de limite de taxa HTTP 429. Veja Como lidar com limites de taxa para orientações.
Se você atingir um limite de taxa não documentado que bloqueie seu caso de uso (ou se desejar limites mais altos para um ponto final), por favor, deixe um feedback explicando suas necessidades no Fórum do Desenvolvedor.
Cabeçalhos de resposta
Muitas respostas de API incluem cabeçalhos que fornecem informações sobre o seu status atual de limite de taxa.
| Cabeçalho | Descrição |
|---|---|
| x-ratelimit-limit | O número total de solicitações permitidas dentro da janela de limite de taxa. Isso pode incluir vários valores de limite para diferentes janelas de tempo. |
| x-ratelimit-remaining | O número de solicitações que você ainda pode fazer com sua autenticação atual. Quando isso atinge 0, você recebe respostas HTTP 429. |
| x-ratelimit-reset | O número de segundos restantes até que sua cota de limite de taxa seja redefinida para o limite total. |
Aqui está um exemplo de cabeçalhos de limite de taxa em uma resposta da API:
Neste exemplo:
- Você tem 998 solicitações restantes do seu limite total.
- Sua cota será redefinida em 20 segundos.
Comportamento
O comportamento de limite de taxa difere conforme o método de autenticação e a origem da solicitação, incluindo se você faz solicitações de dentro de um jogo Roblox.
Chave da API
Limites de taxa para chaves de API são aplicados em todas as chaves de API por proprietário, que pode ser um usuário ou um grupo. Esses limites são impostos de maneira consistente, independentemente de onde as solicitações se originem—seja de HttpService, aplicativos da web ou outras fontes.
No jogo com HttpService
Ao chamar pontos finais no jogo usando HttpService, as solicitações também contribuem para o limite fixo de 500 solicitações HTTP por minuto por servidor de jogo Roblox. Veja Solicitações HTTP no jogo para mais detalhes.
OAuth 2.0
Limites de taxa do OAuth 2.0 são aplicados por token de acesso. Como cada token de acesso representa uma combinação única de usuário e aplicativo, cada usuário usando seu aplicativo recebe sua própria cota de limite de taxa independente.
Lidando com limites de taxa
Escreva seu código para esperar e lidar com respostas HTTP 429 (Muitas Solicitações) devido a limites documentados, prevenção de abuso ou cenários de alta carga. Quando for limitado, verifique o cabeçalho de resposta retry-after como um guia sobre quando tentar novamente. Se não houver cabeçalho de resposta retry-after presente, implemente uma estratégia de retry com backoff exponencial.