Entendendo os limites de taxa de API

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

Encontre detalhes técnicos e exemplos em nossa documentação para desenvolvedores sobre limites de taxa.

Tipos de limites de taxa

1. Limite de complexidade

Controla o "peso" de uma consulta. A maioria dos usuários não se deparará com isso, mas, se acontecer, você verá um erro:

• Mensagem de erro: COMPLEXITY_BUDGET_EXHAUSTED
• O que fazer:
• Solicite apenas os dados de que precisa
• Evite consultas excessivamente complexas ou com muitos níveis de agrupamento
• Use paginação sempre que possível

2. Limite diário de chamadas

Cada conta tem um limite diário para o número de chamadas de 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ê possui um plano de nível Corporativo, pode solicitar um aumento através do painel de análise da API encontrado na seção Administração na monday.com.

3. Limite de taxa por minuto

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

• Mensagem de erro: Limite de taxa excedido
• 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 a quantidade de chamadas de API que podem ser processadas simultaneamente.

• 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 a partir de um único endereço IP em um curto período de tempo (5.000 solicitações a cada 10 segundos).

• Mensagem de erro: IP_RATE_LIMIT_EXCEEDED
• O que fazer:
• Faça uma pausa antes de tentar novamente, conforme sugerido pelo campo retry_in_seconds na resposta de erro.

Práticas recomendadas gerais

• Todas as solicitações — inclusive aquelas com falha — contam para seus limites.
• Evite tentar novamente as solicitações imediatamente após um erro de limite de taxa. Sempre verifique o campo retry_in_seconds na resposta.
• Se você estiver usando nosso SDK, ele respeitará automaticamente os limites de taxa de resposta e tentará novamente após o tempo de espera apropriado.

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

Precisa de ajuda para otimizar seu uso da API? Entre em contato com nossa equipe de suporte para obter orientação.