Καθολικά όρια

Το Brevo περιορίζει τα αιτήματα API ανά endpoint. Κάθε όριο είναι ένας αριθμός αιτημάτων ανά δευτερόλεπτο (RPS), ανά ώρα (RPH) ή και τα δύο. Τα στοιχεία παρακάτω προέρχονται από τη σελίδα ορίων του Brevo, με έλεγχο στις 7 Οκτωβρίου 2026. Ελέγξτε αυτή τη σελίδα πριν υπολογίσετε το μέγεθος μιας μεγάλης εργασίας.

Επίπεδα ορίων ρυθμού

Όρια ανά επίπεδο

Όταν ένα endpoint έχει και όριο RPS και όριο RPH, μένετε κάτω και από τα δύο.

Κεφαλίδες ορίων ρυθμού

Τα endpoints με όριο ρυθμού επιστρέφουν αυτές τις κεφαλίδες:

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

Περιγραφές των κεφαλίδων

• x-sib-ratelimit-limit: τα αιτήματα που επιτρέπονται στο τρέχον παράθυρο
• x-sib-ratelimit-remaining: τα αιτήματα που απομένουν στο τρέχον παράθυρο
• x-sib-ratelimit-reset: ο χρόνος μέχρι να μηδενιστεί το παράθυρο, συνήθως σε δευτερόλεπτα

Το Brevo τεκμηριώνει αυτές τις κεφαλίδες στη σελίδα του για τις κεφαλίδες ορίων.

Παρακολούθηση της χρήσης

Έλεγχος της τρέχουσας χρήσης

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

Διαχείριση των ορίων ρυθμού

Εκθετική αναμονή

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

Όταν συνεχίζετε να φτάνετε στα όρια

1. Κατανέμετε τα αιτήματα ομοιόμορφα: ένα όριο 1.000 RPS επιτρέπει έως 60.000 αιτήματα το λεπτό μόνο όταν τα αιτήματα κατανέμονται ομοιόμορφα.
2. Ομαδοποιήστε και αποθηκεύετε στην cache: χρησιμοποιήστε endpoints μαζικών λειτουργιών και αποφύγετε την εκ νέου ανάγνωση δεδομένων που ήδη έχετε.
3. Χρησιμοποιήστε webhooks για στατιστικά: λαμβάνετε συμβάντα αντί να κάνετε polling στα endpoints στατιστικών.
4. Εξετάστε ένα υψηλότερο επίπεδο: το προηγμένο και το εκτεταμένο επίπεδο συνοδεύουν τα προγράμματα Professional και Enterprise.