Globális korlátok

A Brevo végpontonként korlátozza az API-kéréseket. Minden korlát másodpercenkénti kéréseket (RPS), óránkénti kéréseket (RPH) vagy mindkettőt jelent. Az alábbi számok a Brevo korlátokról szóló oldaláról származnak, 2026. október 7-én ellenőrizve. Nagy feladat méretezése előtt nézd meg azt az oldalt.

Korlátozási szintek

Korlátok szintenként

Ha egy végpontnak RPS és RPH korlátja is van, mindkettő alatt maradj.

Korlátozási fejlécek

A kéréskorláttal védett végpontok ezeket a fejléceket adják vissza:

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

A fejlécek jelentése

• x-sib-ratelimit-limit: az aktuális időablakban engedélyezett kérések száma
• x-sib-ratelimit-remaining: az aktuális időablakban hátralévő kérések száma
• x-sib-ratelimit-reset: az időablak visszaállásáig hátralévő idő, általában másodpercben

A Brevo ezeket a fejléceket a kéréskorlát-fejlécekről szóló oldalán dokumentálja.

A használat követése

Az aktuális használat ellenőrzése

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

A korlátok kezelése

Exponenciális visszalépés

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

Ha folyamatosan korlátba ütközöl

1. Oszd el egyenletesen a kéréseket: az 1 000 RPS korlát csak akkor enged percenként akár 60 000 kérést, ha a kérések egyenletesen oszlanak el.
2. Csomagolj és gyorsítótárazz: használj tömeges végpontokat, és ne olvasd újra azokat az adatokat, amelyek már megvannak.
3. Statisztikákhoz használj webhookokat: eseményeket fogadj a statisztikai végpontok lekérdezgetése helyett.
4. Fontold meg a magasabb szintet: a haladó és a kiterjesztett szint a Professional és az Enterprise csomagokkal jár.