Limites de uso

Duas janelas fixas de um minuto: uma por chave, uma por workspace.

Os dois baldes

Balde	Limite	Janela	Protege
Por chave de API	600 requisições	60s	Você, de um laço com defeito consumir o orçamento do workspace inteiro.
Por workspace	1.800 requisições	60s	A plataforma, para dez chaves não multiplicarem o teto por dez.

Cabeçalhos

Toda resposta autenticada por chave carrega o estado do balde daquela chave.

text

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 583
X-RateLimit-Reset: 41

X-RateLimit-Reset é quantos segundos faltam para a janela virar. Leia esses valores e regule o seu ritmo; não espere pelo 429.

Quando você estoura

json

HTTP/1.1 429 Too Many Requests
Retry-After: 41

{
  "error": "RATE_LIMITED",
  "message": "Too many requests. Retry after the window resets.",
  "request_id": "req_01J..."
}

As janelas são fixas, não deslizantes. Isso significa que a fronteira é uma borda de verdade: 600 requisições às 10:00:59 e mais 600 às 10:01:00 passam as duas. Estamos dizendo isso em vez de deixar você descobrir, porque distribuir o ritmo é mais barato para os dois lados do que achar a borda em produção.

Se o nosso limitador estiver indisponível

Ele falha aberto. Um limitador que derruba a API quando o próprio banco dele pisca transforma um problema de capacidade em indisponibilidade. Você simplesmente não verá os cabeçalhos nessas requisições.