Limite globale

Brevo limitează cererile API per endpoint. Fiecare limită este un număr de cereri pe secundă (RPS), pe oră (RPH) sau ambele. Cifrele de mai jos provin de pe pagina Brevo despre limitele de rată, verificată la 7 octombrie 2026. Verifică acea pagină înainte de a dimensiona o sarcină mare.

Niveluri de limite de rată

Limite pe niveluri

Când un endpoint are atât o limită RPS, cât și una RPH, rămâi sub amândouă.

Anteturile pentru limita de rată

Endpointurile cu limită de rată returnează aceste anteturi:

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

Descrierea anteturilor

• x-sib-ratelimit-limit: cereri permise în fereastra curentă
• x-sib-ratelimit-remaining: cereri rămase în fereastra curentă
• x-sib-ratelimit-reset: timpul până la resetarea ferestrei, de obicei în secunde

Brevo documentează aceste anteturi pe pagina sa despre anteturile limitelor de rată.

Monitorizarea consumului

Verificarea consumului curent

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'))
  });
};

Gestionarea limitelor de rată

Backoff exponențial

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');
};

Când tot atingi limitele

1. Distribuie cererile uniform: o limită de 1.000 RPS permite până la 60.000 de cereri pe minut doar dacă ele sunt distribuite uniform.
2. Grupează și păstrează în cache: folosește endpointurile în masă și evită recitirea datelor pe care le ai deja.
3. Folosește webhookuri pentru statistici: primește evenimente în loc să interoghezi repetat endpointurile de statistici.
4. Ia în calcul un nivel superior: nivelurile avansat și extins vin cu planurile Professional și Enterprise.