日本語

Quota & Rate Limit

모듈별 월간 quota와 초당 rate limit이 자동 적용됩니다. 80% 도달 시 webhook 경고, 100% 도달 시 429를 반환하며, 초과 사용은 자동 결제되지 않습니다.

개요

모든 플랜은 모듈별 월간 quota가 정의되어 있습니다. 매월 1일 00:00 UTC에 리셋되며, 사용량은 대시보드의 Usage 탭에서 실시간 조회할 수 있습니다.

계량 단위

  • Lingua — words 조회 1회 = 1 unit, batch는 conceptKey 개수만큼 카운트
  • Gamify — event 1건 = 1 unit, 프로필/랭킹 조회는 0.1 unit
  • Notify — push 발송 1건 = 1 unit (실패해도 카운트), 브로드캐스트는 수신자 수만큼
  • AdMesh — 광고 서빙 1회 = 1 unit, 이벤트 트래킹은 무료
  • Anon — 게시글/댓글 작성 = 1 unit, 조회는 0.1 unit
  • Oracle — 단일 조회 = 1 unit

Rate Limit

모든 키는 기본 100 req/s로 제한되며, Pro 이상 플랜은 1,000 req/s까지 상향됩니다. 응답 헤더로 현재 상태를 확인할 수 있습니다.

http
HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1748140800
X-Quota-Module: lingua
X-Quota-Limit: 100000
X-Quota-Used: 42351

80% 경고

월 사용량이 80%에 도달하면 등록된 webhook으로 quota.warning 이벤트가 발송됩니다. 동시에 워크스페이스 OWNER에게 이메일 알림이 전송됩니다.

100% 초과

quota 초과 시 해당 모듈은 429 QUOTA_EXCEEDED를 반환합니다. 예상치 못한 청구를 방지하기 위해 자동 결제로 한도가 늘어나지 않습니다. 한도 상향은 대시보드에서 플랜 업그레이드 또는 일회성 크레딧 구매로 진행해야 합니다.

json
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Monthly quota exceeded for module 'notify'.",
    "module": "notify",
    "limit": 50000,
    "used": 50001,
    "resetAt": "2026-06-01T00:00:00Z"
  }
}
PreviousMulti-tenancyNextWebhooks