Limites de Taxa
A API da Brevo limita os pedidos por endpoint, não por dia. Cada limite é um número de pedidos por segundo (RPS), por hora (RPH) ou ambos, e quando os dois se aplicam você precisa ficar abaixo de ambos. Exceder um limite retorna 429 Too Many Requests.
Limites do nível geral
O nível geral se aplica a todos os planos da Brevo: Free, Starter, Standard, Professional e Enterprise. Estes são os limites que a Brevo publica para ele:
| Endpoint | Limite |
|---|---|
POST /v3/smtp/email, GET /v3/smtp/blockedContacts | 1.000 RPS, 3.600.000 RPH |
POST /v3/transactionalSMS/send | 150 RPS, 540.000 RPH |
Todos os endpoints em /v3/contacts | 10 RPS, 36.000 RPH |
POST /v3/events | 10 RPS, 36.000 RPH |
POST /v3/orders/status | 5 RPS, 18.000 RPH |
POST /v3/products | 2 RPS, 7.200 RPH |
GET /v3/smtp/emails | 2 RPS, 7.200 RPH |
Outros endpoints em /v3/smtp | 300 RPH |
Todos os endpoints em /v3/loyalty | 600 RPH |
| Todos os outros endpoints | 100 RPH |
As contas Professional e Enterprise podem usar o nível avançado, que dobra a maioria desses limites. As contas Enterprise podem usar o nível estendido, o mais alto. Veja Limites globais para os três níveis lado a lado, e a página de limites de taxa da Brevo para os valores atuais.
Cabeçalhos de limite de taxa
Os endpoints com limite de taxa retornam três cabeçalhos:
x-sib-ratelimit-limit: 1000x-sib-ratelimit-remaining: 750x-sib-ratelimit-reset: 1x-sib-ratelimit-limit: pedidos permitidos na janela atualx-sib-ratelimit-remaining: pedidos restantes na janela atualx-sib-ratelimit-reset: tempo até a janela ser reiniciada, normalmente em segundos
Boas Práticas
- Monitorar os cabeçalhos de limite de taxa
- Implementar backoff exponencial para novas tentativas
- Distribuir os pedidos de forma uniforme ao longo da janela
- Armazenar respostas em cache quando possível
- Usar webhooks em vez de polling