Neste artigo:

1. Por que estou recebendo erros HTTP 503 na API?
2. Qual é o limite de requisições da API?
3. O que acontece quando o limite é excedido?
4. Quanto tempo dura o bloqueio após atingir o limite?
5. É possível listar todas as atividades sem percorrer pasta por pasta?
6. A credencial de integração possui um limite diferente?
7. Como evitar novos bloqueios?

1. Por que estou recebendo erros HTTP 503 na API?

Os erros HTTP 503 ocorrem quando a política de limitação de requisições da API é acionada. Isso não indica indisponibilidade do serviço, mas sim que o limite de requisições por minuto foi atingido pelo seu endereço IP.

2. Qual é o limite de requisições da API?

O endpoint https://api.artia.com/graphql permite até 300 requisições por minuto por endereço IP de origem. O limite não é aplicado por usuário ou organização, ou seja, todas as requisições vindas do mesmo IP compartilham o mesmo contador.

Por exemplo, ao realizar aproximadamente 10 requisições por segundo com 8 chamadas simultâneas, o limite é atingido em cerca de 30 segundos.

3. O que acontece quando o limite é excedido?

Quando o limite é atingido, a API retorna o código HTTP 503. Não são disponibilizados cabeçalhos de cota ou tempo de espera como Retry-After ou X-RateLimit-*.

4. Quanto tempo dura o bloqueio após atingir o limite?

Após atingir o limite, o endereço IP permanece bloqueado por 1 hora. O bloqueio é removido automaticamente ao final desse período. Novas tentativas realizadas durante o bloqueio não reiniciam nem prolongam sua duração.

5. É possível listar todas as atividades sem percorrer pasta por pasta?

Na estrutura atual da API, a consulta listingActivities exige o preenchimento do folderId. Não existe uma opção para listar todas as atividades diretamente pelo grupo de trabalho, nem filtros por responsável, período ou paginação nesse escopo.

Para realizar uma varredura completa sem acionar o bloqueio, recomendamos:

• Manter um ritmo de 4 a 5 requisições por segundo
• Utilizar lotes de até 290 chamadas com intervalo de 1 minuto entre eles
• Considerar no mesmo limite todas as demais chamadas realizadas pela integração, como autenticação, listingProjects e listingFolders

6. A credencial de integração possui um limite diferente?

Não. O limite é aplicado pelo endereço IP, antes da autenticação. Por esse motivo, o comportamento é o mesmo para tokens obtidos por authenticationByEmail ou por credenciais de integração utilizando clientId e secret.

7. Como evitar novos bloqueios?

• Reduza a concorrência de requisições simultâneas
• Controle a quantidade de requisições por minuto, mantendo abaixo de 300 por IP
• Adote uma varredura incremental em vez de varreduras completas em rajada
• Considere todas as chamadas da integração no mesmo contador, incluindo autenticação e listagens de projetos e pastas

Ainda tem dúvidas? Fale com um de nossos consultores pelo chat em artia.com ou pelo e-mail [email protected].