Globálne limity

Brevo obmedzuje požiadavky API podľa endpointu. Každý limit je počet požiadaviek za sekundu (RPS), za hodinu (RPH), alebo oboje. Nižšie uvedené hodnoty pochádzajú zo stránky s limitmi Brevo, skontrolovanej 7. októbra 2026. Skôr než naplánujete rozsiahlu úlohu, túto stránku si skontrolujte.

Úrovne limitov

Limity podľa úrovne

Ak má endpoint limit RPS aj RPH, zostaňte pod oboma.

Hlavičky s limitmi požiadaviek

Endpointy s limitmi požiadaviek vracajú tieto hlavičky:

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

Popis hlavičiek

• x-sib-ratelimit-limit: počet požiadaviek povolených v aktuálnom okne
• x-sib-ratelimit-remaining: počet požiadaviek zostávajúcich v aktuálnom okne
• x-sib-ratelimit-reset: čas do resetu okna, zvyčajne v sekundách

Brevo tieto hlavičky dokumentuje na stránke o hlavičkách limitov.

Sledovanie spotreby

Kontrola aktuálnej spotreby

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

Práca s limitmi

Exponenciálny backoff

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

Keď limity narážate opakovane

1. Rozkladajte požiadavky rovnomerne: limit 1 000 RPS umožňuje až 60 000 požiadaviek za minútu iba vtedy, ak sú rozložené rovnomerne.
2. Dávkujte a ukladajte do vyrovnávacej pamäte: používajte hromadné endpointy a nenačítavajte znova dáta, ktoré už máte.
3. Na štatistiky používajte webhooky: prijímajte udalosti namiesto dopytovania endpointov so štatistikami.
4. Zvážte vyššiu úroveň: pokročilá a rozšírená úroveň sú súčasťou plánov Professional a Enterprise.