Ú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.
| Plano | Requisições por segundo | Requisições por minuto | Requisições por dia | Chaves ativas |
|---|---|---|---|---|
| Free | 1 | 60 | 5,000 | 1 |
| Starter | 5 | 300 | 15,000 | 3 |
| Pro | 20 | 1,200 | 100,000 | 10 |
| Agency | 60 | 3,600 | 400,000 | 25 |
| Enterprise | 150 | 9,000 | 1,200,000 | ilimitadas |
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/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Minute-Limit: 1200X-RateLimit-Minute-Remaining: 1187X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431Como é 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.
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.
resetAt em vez de usar um temporizador fixo e prefira webhooks a polling para eventos de LIVE.