Limites de requisições

A API aplica limites por chave, com janelas por segundo, minuto e dia. Consulte GET /v1/team: o objeto data.api.rate_limits descreve os tetos efetivos.

Campo	Janela	O que conta
rps_burst	Segundo	Leituras e escritas
rpm_read	Minuto	Leituras
rpm_write	Minuto	Escritas
rpd	Dia	Leituras e escritas

Os valores são configuráveis por oferta e podem ter ajustes por chave. Não codifique uma tabela fixa de preços ou cotas na integração. Uma oferta somente leitura não permite escrever, mesmo que a chave tenha um escopo de escrita.

Ao receber 429

Respeite o cabeçalho Retry-After, em segundos, antes de tentar novamente. Plano, tetos e contagem restante não são repetidos nas demais respostas.

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 60

Distribua o tráfego ao longo da janela, limite o paralelismo e use espera crescente com pequena variação aleatória. Em escritas, preserve a mesma Idempotency-Key e o mesmo corpo nas novas tentativas.

Erros de validação ou recursos inexistentes também podem consumir cota quando a chamada já chegou à etapa de limite. Tentativas de autenticação inválidas usam um limitador separado por IP.

Veja Equipe e limites, Idempotência e Paginação.