API 호출 한도 (Rate Limits)
비볼디는 모든 사용자에게 최적의 서비스 환경을 보장하기 위해 요금제별 API 호출 한도를 운영하고 있습니다.
정해진 한도가 초과되면 HTTP 429 (Too Many Requests) 오류가 반환됩니다. 이 응답을 받으시면 일정 시간이 경과한 후 다시 요청을 시도해 주시기 바랍니다.
요금제별 API 호출 한도
아래 표는 요금제별 분당·시간당 API 호출 한도를 정리한 것입니다.
서비스 규모와 트래픽 패턴에 따라 적용 가능한 호출량이 달라질 수 있으며 안정적인 API 운영을 위해 요청 제한 정책이 적용됩니다.
| 요금제 | 분당 호출 한도 | 시간당 호출 한도 | 통계 API 분당 호출 한도 | 통계 API 동시 요청 |
|---|---|---|---|---|
| 무료 | 30 | 600 | 기본 분당 한도의 5% | — |
| 퍼스널 | 180 | 10,000 | 기본 분당 한도의 5% | 1 |
| 프리미엄 | 300 | 15,000 | 기본 분당 한도의 5% | 1 |
| 비즈니스 | 480 | 25,000 | 기본 분당 한도의 5% | 2 |
| 비즈니스 플러스 | 768 | 40,000 | 기본 분당 한도의 5% | 2 |
| 엔터프라이즈 | 1,200 | 60,000 | 기본 분당 한도의 5% | 계약별 (기본 3) |
API 호출 한도 초과 시 대처 방법
API 호출 한도를 초과하면 HTTP 429 (Too Many Requests) 응답이 반환됩니다.
안정적인 서비스 운영을 위해 아래와 같은 방식으로 요청 처리 로직을 구성하는 것을 권장합니다.
1. 재시도 로직 구현 (Retry with Backoff)
429 응답 수신 시 일정 시간 대기 후 다시 요청하는 재시도 로직을 구현하세요.
짧은 간격으로 반복 요청하는 대신 Exponential Backoff 방식 사용을 권장합니다.
2. 호출 빈도 최적화
동일한 데이터를 반복 요청하는 경우 캐시(Cache)를 활용하여 불필요한 API 호출을 줄일 수 있습니다.
대량 작업은 단건 요청보다 배치 처리 방식이 효율적입니다.
3. 높은 호출량 환경 대응
지속적으로 호출 한도에 근접하는 환경에서는 상위 요금제 또는 유동 호출 한도가 적용되는 비즈니스 플러스·엔터프라이즈 요금제를 고려할 수 있습니다.
비즈니스 플러스 · 엔터프라이즈 유동 한도
비즈니스 플러스·엔터프라이즈 요금제는 고정 호출 한도 대신 월간 링크 생성량에 따라 API 호출 한도가 자동으로 확장되는 유동 방식을 적용합니다.
대량 링크를 운영하는 마케팅 플랫폼, 이커머스 서비스, 기업 내부 시스템 등에 적합하며 높은 트래픽 환경에서도 유연하게 대응할 수 있도록 설계되어 있습니다.
- 기본 기준: 월 10,000 링크 생성
- 서비스 안정성을 위해 최대 확장 한도는 기본 한도의 3.5배로 제한됩니다.
예시 (엔터프라이즈 요금제)
- 월 10,000 링크 → 분당 1,200회 / 시간당 60,000회
- 월 30,000 링크 → 분당 2,000회 / 시간당 100,000회
※ Webhook 호출 한도는 일반 API 한도의 80%가 적용됩니다.
※ 실제 적용 한도는 계약 조건 및 서비스 정책에 따라 달라질 수 있으며, 더 높은 호출 한도가 필요한 경우 고객센터로 문의해 주세요.