Globalna ograničenja

Brevo ograničava API zahtjeve po krajnjoj točki. Svako ograničenje je broj zahtjeva u sekundi (RPS), na sat (RPH) ili oboje. Brojke u nastavku potječu sa Brevo stranice s ograničenjima, provjerene 7. listopada 2026. Prije planiranja velikog zadatka provjerite tu stranicu.

Razine ograničenja

Ograničenja po razini

Kad krajnja točka ima i RPS i RPH ograničenje, ostanite ispod oba.

Zaglavlja s ograničenjem broja zahtjeva

Krajnje točke s ograničenjem broja zahtjeva 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 zahtjeva dopuštenih u trenutnom prozoru
• x-sib-ratelimit-remaining: broj zahtjeva preostalih u trenutnom prozoru
• x-sib-ratelimit-reset: vrijeme do resetiranja prozora, obično u sekundama

Brevo ta zaglavlja dokumentira na stranici o zaglavljima ograničenja.

Praćenje potrošnje

Provjera 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 s 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 dosežete ograničenja

1. Rasporedite zahtjeve ravnomjerno: ograničenje od 1.000 RPS dopušta do 60.000 zahtjeva u minuti samo ako su ravnomjerno raspoređeni.
2. Grupirajte i predmemorirajte: koristite skupne krajnje točke i ne čitajte ponovno podatke koje već imate.
3. Za statistiku koristite webhookove: primajte događaje umjesto ispitivanja krajnjih točaka sa statistikom.
4. Razmotrite višu razinu: napredna i proširena razina dolaze uz planove Professional i Enterprise.