Limites de uso

Requisições

Onde	Limite	Por
Toda a API	5.000 requisições a cada 5 minutos	IP
Servidor MCP	120 requisições por minuto	Credencial
Servidor MCP — escritas	10 por minuto	Credencial
Servidor MCP — falhas de autenticação	20 por minuto	IP
Troca de empresa (/auth/switch-tenant)	10 por minuto	Usuário

Rotas públicas têm limites próprios, descritos em cada guia — por exemplo, o quiosque de ponto e o widget de atendimento.

Os limites por minuto são janelas fixas de um minuto. Ao excedê-los, a API responde 429, sem o cabeçalho Retry-After: espere a virada do minuto e tente de novo.

Tamanho do corpo

Corpo acima de 8 KB

A API fica atrás de um firewall de aplicação. Requisições com corpo acima de 8 KB são recusadas com 403 antes de chegar à API, exceto nas rotas de upload de arquivo e de mensagem para a Tali. Esse 403 não traz JSON — é o sinal de que a requisição parou no firewall, e não numa regra de permissão.

Para enviar muitos registros, divida em lotes menores. Corpos com conteúdo que se pareça com um ataque (injeção de SQL, script, inclusão de URL remota) também são recusados do mesmo jeito.

Para saber se a recusa veio do firewall ou da API, repita a chamada sem o cabeçalho Authorization: 401 com JSON significa que ela chegou à API; 403 sem JSON, que parou antes.

Uploads

Limite	Valor
Tamanho por arquivo	150 MB
Tamanho por requisição	150 MB

Tempo de resposta

Rotas de relatório e de cálculo (folha, apuração de ponto, exportações) podem levar dezenas de segundos. Configure o seu cliente HTTP com um tempo limite de pelo menos 60 segundos para essas rotas.

Boas práticas

• Pagine com size de 50 a 200 em vez de pedir tudo de uma vez.
• Reaproveite o token por 24 horas em vez de logar a cada chamada.
• Em integrações agendadas, espalhe as execuções — não dispare todas no mesmo minuto.