---
title: "전역 제한 | Tajo"
description: "Brevo의 세 가지 API 속도 제한 등급, 등급별 제한, 그리고 429를 처리하는 방법"
url: https://tajo.io/kr/docs/rate-limits/global-limits/
markdown: https://tajo.io/kr/docs/rate-limits/global-limits.md
lang: ko-KR
author: "Set Noa"
author_url: https://tajo.io/kr/set-noa/
robots: noindex
---

Tajo 사전 이용 신청

이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다.

# 전역 제한

[Set Noa](https://tajo.io/kr/set-noa/)

Brevo는 엔드포인트별로 API 요청을 제한합니다. 각 제한은 초당 요청 수(RPS), 시간당 요청 수(RPH) 또는 둘 다로 표시됩니다. 아래 수치는 Brevo의 [요청 한도 페이지](https://developers.brevo.com/docs/api-limits)에서 가져온 것이며 2026년 10월 7일에 확인했습니다. 대규모 작업의 규모를 정하기 전에 해당 페이지를 확인하세요.

## 속도 제한 등급

| 등급 | 이용 가능한 요금제 |
| --- | --- |
| **General** | Free, Starter, Standard, Professional, Enterprise |
| **Advanced** | Professional, Enterprise |
| **Extended** | Enterprise |

## 등급별 제한

| 엔드포인트 | General | Advanced | Extended |
| --- | --- | --- | --- |
| `POST /v3/smtp/email`, `GET /v3/smtp/blockedContacts` | 1,000 RPS, 3,600,000 RPH | 2,000 RPS, 7,200,000 RPH | 6,000 RPS |
| `GET /v3/smtp/emails` | 2 RPS, 7,200 RPH | 3 RPS, 10,800 RPH | 18,000 RPH |
| `POST /v3/transactionalSMS/send` | 150 RPS, 540,000 RPH | 200 RPS, 720,000 RPH | 250 RPS |
| `POST /v3/events` | 10 RPS, 36,000 RPH | 20 RPS, 72,000 RPH | 60 RPS |
| `POST /v3/orders/status` | 5 RPS, 18,000 RPH | 10 RPS, 36,000 RPH | 15 RPS |
| `POST /v3/products` | 2 RPS, 7,200 RPH | 4 RPS, 14,400 RPH | 21,600 RPH |
| `/v3/smtp` 아래의 기타 엔드포인트 | 300 RPH | 600 RPH | 1,800 RPH |
| `/v3/contacts` 아래의 모든 엔드포인트 | 10 RPS, 36,000 RPH | 20 RPS, 72,000 RPH | 60 RPS |
| `/v3/loyalty` 아래의 모든 엔드포인트 | 600 RPH | 1,200 RPH | 100,000 RPH |
| 그 밖의 모든 엔드포인트 | 100 RPH | 200 RPH | 600 RPH |

엔드포인트에 RPS와 RPH 제한이 모두 있는 경우 두 제한을 모두 지켜야 합니다.

## 속도 제한 헤더

요청 한도가 적용되는 엔드포인트는 다음 헤더를 반환합니다:

```http
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는 이 헤더를 [요청 한도 헤더 페이지](https://developers.brevo.com/docs/limit-headers)에 문서화하고 있습니다.

## 사용량 모니터링

### 현재 사용량 확인

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

## 속도 제한 처리

### 지수 백오프

```javascript
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. **일괄 처리와 캐싱**: 대량 처리 엔드포인트를 사용하고 이미 가진 데이터를 다시 읽지 마세요.
3. **통계에는 웹훅을 사용하세요**: 통계 엔드포인트를 폴링하는 대신 이벤트를 수신하세요.
4. **상위 등급을 고려하세요**: Advanced 및 Extended 등급은 Professional 및 Enterprise 요금제에 포함됩니다.