Batas global

Brevo membatasi permintaan API per endpoint. Setiap batas adalah jumlah permintaan per detik (RPS), per jam (RPH), atau keduanya. Angka di bawah berasal dari halaman batas laju Brevo, diperiksa pada 7 Oktober 2026. Periksa halaman itu sebelum Anda menentukan ukuran pekerjaan besar.

Tingkatan batas laju

Batas menurut tingkatan

Bila sebuah endpoint memiliki batas RPS dan RPH, tetaplah di bawah keduanya.

Header batas laju

Endpoint yang dibatasi laju mengembalikan header berikut:

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

Penjelasan header

• x-sib-ratelimit-limit: permintaan yang diizinkan dalam jendela saat ini
• x-sib-ratelimit-remaining: permintaan yang tersisa dalam jendela saat ini
• x-sib-ratelimit-reset: waktu hingga jendela di-reset, biasanya dalam detik

Brevo mendokumentasikan header ini di halaman header batas laju.

Memantau penggunaan

Periksa penggunaan saat ini

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

Menangani batas laju

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

Jika Anda terus mencapai batas

1. Sebarkan permintaan secara merata: batas 1.000 RPS hanya mengizinkan hingga 60.000 permintaan per menit bila permintaan tersebar merata.
2. Batch dan cache: gunakan endpoint massal dan hindari membaca ulang data yang sudah Anda miliki.
3. Gunakan webhook untuk statistik: terima event alih-alih melakukan polling pada endpoint statistik.
4. Pertimbangkan tingkatan yang lebih tinggi: tingkatan lanjutan dan diperluas disertakan pada paket Professional dan Enterprise.