전역 제한

Brevo는 공정한 사용과 최적의 성능을 보장하기 위해 모든 API 엔드포인트에 전역 속도 제한을 적용합니다.

속도 제한 등급

Free 요금제

• 일일 제한: 300회 요청
• 시간당 제한: 50회 요청
• 버스트 제한: 분당 10회 요청
• 이메일 크레딧: 월 300건

Starter 요금제

• 일일 제한: 20,000회 요청
• 시간당 제한: 1,000회 요청
• 버스트 제한: 분당 100회 요청
• 이메일 크레딧: 무제한

Business 요금제

• 일일 제한: 50,000회 요청
• 시간당 제한: 3,000회 요청
• 버스트 제한: 분당 300회 요청
• 이메일 크레딧: 무제한

Enterprise 요금제

• 일일 제한: 맞춤 설정 (100,000회 이상)
• 시간당 제한: 맞춤 설정 (10,000회 이상)
• 버스트 제한: 맞춤 설정 (분당 1,000회 이상)
• 이메일 크레딧: 무제한

속도 제한 헤더

모든 API 응답에는 속도 제한 정보가 포함됩니다.

HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
X-RateLimit-Retry-After: 3600

헤더 설명

• X-RateLimit-Limit: 현재 구간에서 허용되는 전체 요청 수
• X-RateLimit-Remaining: 현재 구간에 남아 있는 요청 수
• X-RateLimit-Reset: 제한이 초기화되는 시점의 Unix 타임스탬프
• X-RateLimit-Retry-After: 재시도 전에 대기해야 하는 초

사용량 모니터링

현재 사용량 확인

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-RateLimit-Limit'),
    remaining: response.headers.get('X-RateLimit-Remaining'),
    reset: new Date(response.headers.get('X-RateLimit-Reset') * 1000)
  });
};

대시보드 모니터링

1. Brevo 대시보드에 로그인합니다
2. Settings → API Keys로 이동합니다
3. 각 API 키의 사용량을 확인합니다
4. 제한에 근접할 때 알림이 오도록 알림을 설정합니다

속도 제한 초기화 구간

• 일일 제한: 00:00 UTC에 초기화
• 시간당 제한: 매시 정각(:00분)에 초기화
• 버스트 제한: 슬라이딩 윈도(최근 60초)

속도 제한 대응

지수 백오프

const makeRequestWithBackoff = async (url, options, maxRetries = 3) => {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);

      if (response.status === 429) {
        const retryAfter = response.headers.get('X-RateLimit-Retry-After') || 60;
        const delay = Math.min(1000 * Math.pow(2, i), retryAfter * 1000);

        console.log(`Rate limited. Waiting ${delay}ms before retry ${i + 1}`);
        await new Promise(resolve => setTimeout(resolve, delay));
        continue;
      }

      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
};

요금제 업그레이드

속도 제한에 지속적으로 도달한다면 다음을 검토하세요.

1. 사용량 분석: 가장 많이 사용하는 엔드포인트를 확인합니다
2. 코드 최적화: 캐싱과 배치 처리를 구현합니다
3. 업그레이드 검토: 필요하다면 상위 등급으로 전환합니다
4. 영업팀 문의하기: 엔터프라이즈 요건이 있는 경우

속도 제한 예외

웹훅 엔드포인트

• 표준 속도 제한이 적용되지 않습니다
• 별도의 웹훅 전송 제한이 적용됩니다

헬스 체크 엔드포인트

• /v3/ping에는 완화된 제한이 적용됩니다
• 모니터링과 가동 시간 점검을 위해 설계되었습니다

배치 작업

• 단일 요청으로 계산되지만 페이로드 제한이 있을 수 있습니다
• 개별 요청을 여러 번 보내는 것보다 효율적입니다