Entendendo os Limites de Taxa da API

Para garantir a confiabilidade e o desempenho da API, a monday.com aplica vários limites de taxa. Esses limites ajudam a gerenciar a carga do sistema e garantem o uso justo entre todos os usuários. Ultrapassar esses limites pode levar a erros temporários, mas compreendê-los ajudará a evitar interrupções.

Você pode encontrar detalhes técnicos e exemplos na documentação do desenvolvedor sobre limites de taxa.

Tipos de Limites de Taxa

1. Limite de Complexidade

Isso controla quão “pesada” é uma consulta. A maioria dos usuários não atingirá isso, mas se você o fizer, verá um erro:

• Mensagem de Erro: COMPLEXITY_BUDGET_EXHAUSTED
• O que fazer:
• Solicite apenas os dados que você precisa
• Evite consultas excessivamente complexas ou profundamente aninhadas
• Use paginação sempre que possível

2. Limite de Chamadas Diárias

Cada conta tem um limite diário no número de chamadas à API:

• Mensagem de Erro: DAILY_LIMIT_EXCEEDED

• O que fazer:
• Otimize seu código para reduzir chamadas desnecessárias
• Aguarde até que o limite seja redefinido à meia-noite UTC
• Se você tiver um plano de nível Enterprise, pode solicitar um aumento através do painel de análise da API encontrado na Seção de Administração da monday.com.

3. Limite de Taxa por Minuto

Limita o número de consultas por minuto. Se excedido:

• Mensagem de Erro: Rate Limit Exceeded
• O que fazer:
• Reduza a frequência das solicitações
• Use o cabeçalho Retry-After para saber quando você pode tentar novamente com segurança.

4. Limite de Concorrência

Restringe quantas chamadas à API podem ser tratadas ao mesmo tempo.

• Mensagem de Erro: maxConcurrencyExceeded
• O que fazer:
• Envie menos solicitações em paralelo
• Adicione lógica de repetição para aguardar antes de tentar novamente

5. Limite de IP

Limita o número de solicitações de um único IP em um curto período (5.000 solicitações a cada 10 segundos).

• Mensagem de Erro: IP_RATE_LIMIT_EXCEEDED
• O que fazer:
• Pause antes de tentar novamente, conforme sugerido pelo campo retry_in_seconds na resposta de erro

Melhores práticas gerais

• Todas as solicitações — até mesmo as falhadas — contam para seus limites.
• Evite tentar novamente solicitações imediatamente após um erro de limite de taxa. Sempre verifique o campo retry_in_seconds na resposta.
• Se você estiver usando o SDK da monday.com, ele respeita automaticamente as respostas de limite de taxa e tenta novamente após o tempo de espera apropriado.

Para desenvolvedores, recomenda-se revisar a Documentação Completa sobre Limites de Taxa para entender como os limites se aplicam com base em seu caso de uso e plano.

Precisa de ajuda para otimizar o uso da sua API? Entre em contato com a equipe de suporte para orientações.

Precisa de mais ajuda? O suporte da monday.com está à disposição.

E se você busca otimizar o uso da monday.com no seu time, a Audatia (parceira oficial no Brasil) tem especialistas prontos para ajudar com consultoria e treinamentos. Fale com um consultor →