Ajuda e guias ›
API e integrações
› Rate limits e códigos de erro
Rate limits e códigos de erro
3 min de leitura · API e integrações
Os rate limits previnem o abuso da API. Ao ultrapassar você recebe HTTP 429 com o header Retry-After.
Limites por plano
Trial / Standard: 60 requests / minuto
Profi: 300 requests / minuto
Business: 1000 requests / minuto
O limite é per-token, não per-user (você pode ter vários tokens para diferentes use cases).
Códigos de erro
- 401 Unauthorized: token ausente ou inválido
- 403 Forbidden: o token não tem permissão para a ação (token read-only em endpoint write)
- 404 Not Found: o resource não existe
- 429 Too Many Requests: rate limit ultrapassado, espere Retry-After segundos
- 5xx: erro do servidor, retry com exponential backoff
Boas práticas
- Faça cache das responses para leitura (dados de uptime não mudam a cada segundo)
- Use webhooks em vez de polling onde for possível
- Em operações batch, use delay entre os requests