Globalne omejitve

Brevo omejuje zahteve API po končni točki. Vsaka omejitev je število zahtev na sekundo (RPS), na uro (RPH) ali oboje. Spodnje številke izhajajo s strani Brevo z omejitvami, preverjene 7. oktobra 2026. To stran preverite, preden načrtujete obsežno opravilo.

Ravni omejitev

Omejitve po ravneh

Če ima končna točka omejitev RPS in RPH, ostanite pod obema.

Glave z omejitvami števila zahtev

Končne točke z omejitvami števila zahtev vrnejo te glave:

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

Opis glav

• x-sib-ratelimit-limit: število zahtev, dovoljenih v trenutnem oknu
• x-sib-ratelimit-remaining: število zahtev, preostalih v trenutnem oknu
• x-sib-ratelimit-reset: čas do ponastavitve okna, običajno v sekundah

Brevo te glave dokumentira na strani o glavah omejitev.

Spremljanje porabe

Preverjanje trenutne porabe

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

Ravnanje z omejitvami

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

Če omejitve dosegate ves čas

1. Zahteve enakomerno porazdelite: omejitev 1.000 RPS dovoljuje do 60.000 zahtev na minuto le, če so enakomerno porazdeljene.
2. Združujte in predpomnite: uporabljajte množične končne točke in ne berite znova podatkov, ki jih že imate.
3. Za statistiko uporabljajte webhooke: prejemajte dogodke namesto poizvedovanja po končnih točkah s statistiko.
4. Razmislite o višji ravni: napredna in razširjena raven sta del paketov Professional in Enterprise.