Limites Globais

A Brevo limita os pedidos da API por endpoint. Cada limite é um número de pedidos por segundo (RPS), por hora (RPH) ou ambos. Os valores abaixo vêm da página de limites de taxa da Brevo, conferida em 7 de outubro de 2026. Confira essa página antes de dimensionar um job grande.

Níveis de limite de taxa

Limites por nível

Quando um endpoint tem um limite de RPS e um de RPH, fique abaixo dos dois.

Cabeçalhos de limite de taxa

Os endpoints com limite de taxa retornam estes cabeçalhos:

HTTP/1.1 200 OK
x-sib-ratelimit-limit: 1000
x-sib-ratelimit-remaining: 750
x-sib-ratelimit-reset: 1

Descrição dos cabeçalhos

• x-sib-ratelimit-limit: pedidos permitidos na janela atual
• x-sib-ratelimit-remaining: pedidos restantes na janela atual
• x-sib-ratelimit-reset: tempo até a janela ser reiniciada, normalmente em segundos

A Brevo documenta esses cabeçalhos na sua página de cabeçalhos de limite.

Monitorar o uso

Verificar o uso atual

const checkRateLimit = async () => {
  const response = await fetch('https://api.brevo.com/v3/account', {
    headers: { 'api-key': process.env.BREVO_API_KEY }
  });

  console.log({
    limit: response.headers.get('x-sib-ratelimit-limit'),
    remaining: response.headers.get('x-sib-ratelimit-remaining'),
    resetInSeconds: Number(response.headers.get('x-sib-ratelimit-reset'))
  });
};

Lidar com limites de taxa

Backoff exponencial

const makeRequestWithBackoff = async (url, options, maxRetries = 3) => {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) return response;

    const resetSeconds = Number(response.headers.get('x-sib-ratelimit-reset') || 1);
    const delay = Math.max(resetSeconds * 1000, 1000 * Math.pow(2, i));

    console.log(`Rate limited. Waiting ${delay}ms before retry ${i + 1}`);
    await new Promise(resolve => setTimeout(resolve, delay));
  }
  throw new Error('Rate limit retries exhausted');
};

Quando você continua atingindo os limites

1. Distribua os pedidos de forma uniforme: um limite de 1.000 RPS permite até 60.000 pedidos por minuto somente quando eles são distribuídos de forma uniforme.
2. Agrupe e use cache: use endpoints em lote e evite reler dados que você já tem.
3. Use webhooks para estatísticas: receba eventos em vez de consultar os endpoints de estatísticas por polling.
4. Considere um nível mais alto: os níveis avançado e estendido vêm com os planos Professional e Enterprise.