Limites e Cotas (Rate Limits)
Para garantir a estabilidade e disponibilidade da plataforma para todos os clientes, a QuettaCode impõe limites de taxa (Rate Limits) e cotas de uso.
Limites de API (Rate Limiting)
Os limites são aplicados por Tenant (Organização) e por IP.
| Escopo | Limite Padrão | Burst (Pico) | Ação ao Exceder |
|---|---|---|---|
| Geral | 100 req/segundo | 200 req | Retorna 429 Too Many Requests |
| Login | 5 tentativas/min | - | Bloqueio temporário de IP |
| Envio de Mensagens | 50 msg/segundo | 100 msg | Fila (Queue) ou 429 |
Nota: Clientes Enterprise podem solicitar aumento desses limites entrando em contato com o suporte.
Cotas de Negócio (Business Quotas)
Além dos limites técnicos de requisição, existem cotas associadas ao seu plano de faturamento (Módulo Pay).
Módulo Flow (WhatsApp)
- Mensagens Gratuitas (Service): Ilimitado (dentro da janela de 24h).
- Mensagens Pagas (Marketing/Utility): Cobrado por conversa iniciada. O limite de crédito é definido no painel financeiro.
Módulo Suite (Documentos)
- Geração de PDF: Limite mensal de gerações conforme o plano (ex: 1.000 docs/mês no plano Basic).
- Armazenamento: Limite de espaço em disco (GB) para arquivos salvos.
Header Retry-After
Quando você recebe um erro 429 Too Many Requests, a resposta incluirá um cabeçalho Retry-After indicando quantos segundos você deve esperar antes de tentar novamente.
Exemplo:
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 30
Seu cliente deve respeitar esse cabeçalho e pausar as requisições pelo tempo especificado.