RoomScope

Última atualização

Limites de requisição

Duas coisas limitam o quanto você pode ler: uma taxa de requisições por chave de API e os créditos da carteira. Estourar a primeira retorna 429; esgotar a segunda retorna 402.

Taxa de requisições

Os limites valem para cada chave de API; o plano do espaço de trabalho define os números. Uma chave tem um limite por segundo (uma janela deslizante de um segundo) e uma cota diária que reinicia à meia-noite UTC. As sessões do painel não têm limite de requisição.

PlanoRequisições por segundoRequisições por minutoRequisições por diaChaves ativas
Free1605,0001
Starter530015,0003
Pro201,200100,00010
Agency603,600400,00025
Enterprise1509,0001,200,000ilimitadas

Um workspace também tem um limite por minuto compartilhado por todas as suas chaves: uma janela fixa de um minuto em UTC. Ao ultrapassá-lo, a resposta é 429 com o código minute_rate_limit_exceeded e um Retry-After que conta até o minuto seguinte; os cabeçalhos X-RateLimit-Minute-Limit e X-RateLimit-Minute-Remaining mostram o que resta.

Requisições rejeitadas por falta de escopo ou de módulo (403) não são contadas; qualquer requisição que passe pela autenticação é contada, seja qual for o resultado.

Cabeçalhos

Toda resposta que passou pelo limitador informa o saldo restante. X-RateLimit-Limit e X-RateLimit-Remaining descrevem a janela por segundo; o par Daily aparece quando a chave tem uma cota diária.

http
HTTP/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Minute-Limit: 1200X-RateLimit-Minute-Remaining: 1187X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431

Como é um 429

Uma requisição limitada retorna 429 com o código rate_limit_exceeded, o envelope de erro padrão e um cabeçalho Retry-After em segundos inteiros. Espere pelo menos esse tempo antes de tentar de novo; se for limitado outra vez, aumente a espera exponencialmente.

429 Too Many Requests
HTTP/2 429Content-Type: application/jsonRetry-After: 1 {"code":"rate_limit_exceeded","message":"API key rate limit exceeded.","requestId":"3f2b6c1e-…","retryable":true}

Uma cota diária esgotada responde 429 com o código daily_quota_exceeded e um Retry-After que conta até a meia-noite UTC. Os cabeçalhos de cota não são enviados no próprio 429.

Créditos

Independentemente da taxa de requisições, toda leitura é cobrada em créditos da carteira do espaço de trabalho. Leituras em cache são baratas; uma requisição que coleta dados novos custa mais (veja Créditos). Ao atingir o limite, toda chamada cobrada, inclusive leituras em cache, retorna 402 com o código credit_cap_exceeded.

Fique abaixo do limite
Guarde as respostas em cache do seu lado por pelo menos o intervalo de atualização do ranking (rankings por hora mudam uma vez por hora), consulte resetAt em vez de usar um temporizador fixo e prefira webhooks a polling para eventos de LIVE.
Esta página foi útil?