Globální limity

Brevo omezuje požadavky API podle endpointu. Každý limit je počet požadavků za sekundu (RPS), za hodinu (RPH), nebo obojí. Níže uvedené hodnoty pocházejí ze stránky s limity Brevo, zkontrolované 7. října 2026. Než naplánujete rozsáhlou úlohu, tuto stránku si zkontrolujte.

Úrovně limitů

Limity podle úrovně

Pokud má endpoint limit RPS i RPH, zůstaňte pod oběma.

Hlavičky s limity požadavků

Endpointy s limity požadavků vracejí tyto hlavičky:

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

Popis hlaviček

• x-sib-ratelimit-limit: počet požadavků povolených v aktuálním okně
• x-sib-ratelimit-remaining: počet požadavků zbývajících v aktuálním okně
• x-sib-ratelimit-reset: doba do resetu okna, obvykle v sekundách

Brevo tyto hlavičky dokumentuje na stránce o hlavičkách limitů.

Sledování spotřeby

Kontrola aktuální spotřeby

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áce s limity

Exponenciální 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');
};

Když limity narážíte opakovaně

1. Rozkládejte požadavky rovnoměrně: limit 1 000 RPS umožňuje až 60 000 požadavků za minutu pouze tehdy, pokud jsou rozloženy rovnoměrně.
2. Dávkujte a ukládejte do mezipaměti: používejte hromadné endpointy a nenačítejte znovu data, která už máte.
3. Pro statistiky používejte webhooky: přijímejte události místo dotazování endpointů se statistikami.
4. Zvažte vyšší úroveň: pokročilá a rozšířená úroveň jsou součástí tarifů Professional a Enterprise.