Limites de Taxa

Os limites de taxa mantêm o desempenho do tenant previsível. São aplicados por chave de API ao longo de uma janela fixa de 60 segundos.

Níveis

Nível	Pedidos / minuto
`standard` (predefinido)	120
`elevated`	600

O nível da sua chave e o orçamento atual são reportados por GET /v1/auth/context (rate_limit_tier) e GET /v1/usage (rate_limit.limit_per_minute e rate_limit.remaining_per_minute). Leia sempre os valores em tempo real em vez de os fixar no código.

Quando excede o limite

Os pedidos acima do limite devolvem 429 com code: "RATE_LIMITED". Aplique recuo e repita após o reinício da janela.

Desenhar dentro dos limites

Coloque dados de referência em cache e prefira sincronizações incrementais a sondagem de tabela completa.
Use webhooks para atualizações orientadas a eventos em vez de sondagem.
Aplique recuo em 429 e evite tempestades de repetições em paralelo após falhas transitórias.
Combine filtros (search, status, module) para obter menos dados.

Limites de Taxa

Os limites de taxa mantêm o desempenho do tenant previsível. São aplicados por chave de API ao longo de uma janela fixa de 60 segundos.

Níveis

Nível	Pedidos / minuto
`standard` (predefinido)	120
`elevated`	600

Quando excede o limite

Os pedidos acima do limite devolvem 429 com code: "RATE_LIMITED". Aplique recuo e repita após o reinício da janela.

Desenhar dentro dos limites

Coloque dados de referência em cache e prefira sincronizações incrementais a sondagem de tabela completa.
Use webhooks para atualizações orientadas a eventos em vez de sondagem.
Aplique recuo em 429 e evite tempestades de repetições em paralelo após falhas transitórias.
Combine filtros (search, status, module) para obter menos dados.