Limites de requisição

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.

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-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.

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.