Rate Limits

API 요청에는 플랜별 요청 제한이 적용됩니다.

플랜별 제한

플랜요청/분요청/일웹훅/분
Free10010,00010
Pro1,000100,000100
Enterprise10,0001,000,0001,000

응답 헤더

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1711453200

제한 초과 시

HTTP/1.1 429 Too Many Requests
Retry-After: 30

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "status": 429
  }
}

모범 사례

  • Exponential backoff으로 재시도
  • 불필요한 반복 호출 최소화
  • 웹훅을 활용하여 폴링 대신 실시간 수신
  • 응답 캐싱 활용