Batas Laju
API Brevo membatasi permintaan per endpoint, bukan per hari. Setiap batas adalah jumlah permintaan per detik (RPS), per jam (RPH), atau keduanya, dan bila keduanya berlaku Anda harus tetap di bawah keduanya. Melampaui batas mengembalikan 429 Too Many Requests.
Batas pada tingkatan umum
Tingkatan umum berlaku untuk setiap paket Brevo: Free, Starter, Standard, Professional, dan Enterprise. Berikut batas yang dipublikasikan Brevo untuknya:
| Endpoint | Batas |
|---|---|
POST /v3/smtp/email, GET /v3/smtp/blockedContacts | 1.000 RPS, 3.600.000 RPH |
POST /v3/transactionalSMS/send | 150 RPS, 540.000 RPH |
Semua endpoint di bawah /v3/contacts | 10 RPS, 36.000 RPH |
POST /v3/events | 10 RPS, 36.000 RPH |
POST /v3/orders/status | 5 RPS, 18.000 RPH |
POST /v3/products | 2 RPS, 7.200 RPH |
GET /v3/smtp/emails | 2 RPS, 7.200 RPH |
Endpoint lain di bawah /v3/smtp | 300 RPH |
Semua endpoint di bawah /v3/loyalty | 600 RPH |
| Semua endpoint lainnya | 100 RPH |
Akun Professional dan Enterprise dapat menggunakan tingkatan lanjutan, yang menggandakan sebagian besar batas ini. Akun Enterprise dapat menggunakan tingkatan diperluas, yang tertinggi. Lihat Batas global untuk ketiga tingkatan secara berdampingan, dan halaman batas laju Brevo untuk angka terkini.
Header batas laju
Endpoint yang dibatasi laju mengembalikan tiga header:
x-sib-ratelimit-limit: 1000x-sib-ratelimit-remaining: 750x-sib-ratelimit-reset: 1x-sib-ratelimit-limit: permintaan yang diizinkan dalam jendela saat inix-sib-ratelimit-remaining: permintaan yang tersisa dalam jendela saat inix-sib-ratelimit-reset: waktu hingga jendela di-reset, biasanya dalam detik
Praktik terbaik
- Pantau header batas laju
- Terapkan exponential backoff untuk percobaan ulang
- Sebarkan permintaan secara merata sepanjang jendela
- Simpan respons dalam cache bila memungkinkan
- Gunakan webhook alih-alih polling