요청 한도
Brevo API는 하루 단위가 아니라 엔드포인트별로 요청을 제한합니다. 각 제한은 초당 요청 수(RPS), 시간당 요청 수(RPH) 또는 둘 다로 표시되며, 둘 다 적용되는 경우 두 제한을 모두 지켜야 합니다. 제한을 초과하면 429 Too Many Requests가 반환됩니다.
일반 등급의 제한
일반 등급은 모든 Brevo 요금제(Free, Starter, Standard, Professional, Enterprise)에 적용됩니다. 다음은 Brevo가 이 등급에 대해 공개한 제한입니다:
| 엔드포인트 | 제한 |
|---|---|
POST /v3/smtp/email, GET /v3/smtp/blockedContacts | 1,000 RPS, 3,600,000 RPH |
POST /v3/transactionalSMS/send | 150 RPS, 540,000 RPH |
/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 |
/v3/smtp 아래의 기타 엔드포인트 | 300 RPH |
/v3/loyalty 아래의 모든 엔드포인트 | 600 RPH |
| 그 밖의 모든 엔드포인트 | 100 RPH |
Professional 및 Enterprise 계정은 대부분의 제한을 두 배로 늘려 주는 고급 등급을 사용할 수 있습니다. Enterprise 계정은 가장 높은 확장 등급을 사용할 수 있습니다. 세 등급을 나란히 비교한 표는 전역 제한을, 최신 수치는 Brevo의 요청 한도 페이지를 참조하세요.
요청 한도 헤더
요청 한도가 적용되는 엔드포인트는 세 가지 헤더를 반환합니다:
x-sib-ratelimit-limit: 1000x-sib-ratelimit-remaining: 750x-sib-ratelimit-reset: 1x-sib-ratelimit-limit: 현재 윈도우에서 허용되는 요청 수x-sib-ratelimit-remaining: 현재 윈도우에서 남은 요청 수x-sib-ratelimit-reset: 윈도우가 초기화되기까지의 시간 (보통 초 단위)
모범 사례
- 요청 한도 헤더를 모니터링합니다
- 재시도에 지수 백오프를 적용합니다
- 윈도우 전체에 요청을 고르게 분산합니다
- 가능한 경우 응답을 캐싱합니다
- 폴링 대신 웹훅을 사용합니다