— Docs · Limites
Rate limits e cotas
Os limites são calculados no servidor, a cada requisição, combinando o plano ativo, as regras de aquisição do cliente e o teto do próprio endpoint. Vence sempre o menor valor.
Como o limite efetivo é calculado
rpm_efetivo = min(limite_do_cliente, limite_do_plano, limite_do_endpoint) cota_efetiva = min(cota_do_cliente, cota_do_plano)
Limites por plano
| Plano | Requisições/min | Cota mensal |
|---|---|---|
| Starter | 60 | 50.000 chamadas |
| Reseller | 600 | 2.000.000 chamadas |
| Operator | 3.000 | sob contrato |
Regras de aquisição por endpoint
Um endpoint só responde se estiver liberado para aquele cliente. O administrador define, por cliente e por endpoint, se o acesso é permitido, qual o limite por minuto e qual a cota mensal específica.
| Situação | Código HTTP | Erro |
|---|---|---|
| Endpoint não adquirido | 403 | endpoint_not_acquired |
| Endpoint desativado | 403 | endpoint_disabled |
| Sem plano ativo | 402 | no_active_plan |
| Limite por minuto estourado | 429 | rate_limit_exceeded |
| Cota mensal estourada | 429 | monthly_quota_exceeded |
Boas práticas
Leia sempre X-RateLimit-Remaining e faça backoff exponencial ao receber 429, respeitando o instante indicado em X-RateLimit-Reset.