Globalna ograničenja

Brevo ograničava API zahteve po endpointu. Svako ograničenje je broj zahteva u sekundi (RPS), na sat (RPH) ili oba. Brojke ispod potiču sa Brevo stranice sa ograničenjima, proverene 7. oktobra 2026. Pre nego što planirate veliki zadatak, proverite tu stranicu.

Nivoi ograničenja

Ograničenja po nivou

Kada endpoint ima i RPS i RPH ograničenje, ostanite ispod oba.

Zaglavlja ograničenja broja zahteva

Endpointi sa ograničenjem broja zahteva vraćaju ova zaglavlja:

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

Opis zaglavlja

• x-sib-ratelimit-limit: broj zahteva dozvoljenih u trenutnom prozoru
• x-sib-ratelimit-remaining: broj zahteva preostalih u trenutnom prozoru
• x-sib-ratelimit-reset: vreme do resetovanja prozora, obično u sekundama

Brevo ova zaglavlja dokumentuje na stranici o zaglavljima ograničenja.

Praćenje potrošnje

Provera trenutne potrošnje

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

Postupanje sa ograničenjima

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

Ako stalno dostižete ograničenja

1. Rasporedite zahteve ravnomerno: ograničenje od 1.000 RPS dozvoljava do 60.000 zahteva u minuti samo ako su ravnomerno raspoređeni.
2. Grupišite i keširajte: koristite masovne endpointe i ne čitajte ponovo podatke koje već imate.
3. Za statistiku koristite webhook-ove: primajte događaje umesto ispitivanja endpointa sa statistikom.
4. Razmotrite viši nivo: napredni i prošireni nivo dolaze uz planove Professional i Enterprise.