개요
요청 한도(rate limit)는 모든 사용자에게 공정한 사용과 시스템 안정성을 보장합니다. 한도는 플랜에 따라 다릅니다.플랜별 한도
플랜 등급에 따라 요청 한도가 결정됩니다. 상위 플랜일수록 동시성이 늘어나고 요청 할당량이 커지며 백로그 허용치도 커집니다.| 플랜 | 동시성 | 백로그 | 요청 한도 |
|---|---|---|---|
| Free | 기본 | 기본 | 기본 |
| Pro | 상향 | 상향 | 상향 |
| Enterprise | 맞춤 | 맞춤 | 맞춤 |
Enterprise 플랜 세부 사항과 맞춤 요청 한도 구성은 세일즈팀에 문의해 주세요.
작업 백로그
동시성 한도가 허용하는 것보다 많은 작업을 제출하면, 초과된 작업은 거부되는 대신 자동으로 백로그에 추가됩니다. 실행 중인 작업이 완료되면 백로그의 작업이 제출된 순서대로 처리됩니다. 즉, 큐 로직을 직접 관리하지 않아도 배치 작업을 제출할 수 있으며 — API가 대신 처리해 줍니다. 백로그 용량도 플랜 등급에 따라 확장됩니다.모범 사례
- 지수 백오프 구현 - 재시도 간격을 점진적으로 늘리세요
- 클라이언트 측 큐잉 - 동시성이 허용하는 것보다 많은 작업을 제출하지 마세요
- 사용량 모니터링 - 요청 수를 추적해 한도 내에 머무르세요
- 웹훅 사용 - 작업 완료 알림에 webhooks를 사용해 폴링 요청을 줄이세요
다음 단계
API Keys & Billing
API 사용량 및 지표 모니터링
Webhooks
웹훅으로 폴링 줄이기