Ajuda e guiasAPI 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