Rate Limits

API 호출 한도 / Rate Limit

FIDOX API는 두 가지 한도를 적용합니다: 월 호출 한도(월별 총량)와 Rate Limit(초당 최대 요청 수)입니다.

월 호출 한도

과금 대상 API(register, verify, identify, compare)의 성공 호출 합산 기준입니다. 매월 1일 0시(KST)에 초기화됩니다. 플랜별 한도는 요금제 페이지에서 확인하세요.

Free 플랜은 한도 초과 시 API 호출이 차단됩니다(429). 유료 플랜은 초과분이 건당 요금으로 청구됩니다.

Rate Limit (초당 요청 수)

짧은 시간에 과도한 요청이 집중되는 것을 방지합니다. 채널 단위로 적용됩니다. 한도를 초과하면 429 Too Many Requests가 반환됩니다. 플랜별 Rate Limit은 요금제 페이지에서 확인하세요.

응답 헤더로 한도 확인

모든 API 응답에 현재 사용량 정보가 포함됩니다.

Response Headers
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 48
X-RateLimit-Reset: 1700000060

한도 초과 시 처리

옵션설명
Free — 월 한도 초과모든 과금 API 요청이 차단됩니다(429). 다음달 1일 자동 초기화되거나, 유료 플랜으로 업그레이드하면 즉시 해제됩니다.
유료 — 월 한도 초과서비스가 중단되지 않으며, 초과분이 건당 요금으로 청구됩니다.
Rate Limit 초과429 응답. 1~2초 후 재시도하거나, 요청을 분산(throttle)하세요.
대량 등록 작업은 업무 시간 외에 분산 처리하거나, 상위 플랜을 사용하세요.

권장 사항

  • 응답 헤더의 X-RateLimit-Remaining 값을 모니터링해 사전에 대응하세요.
  • 429 응답 시 지수 백오프(exponential backoff) 전략으로 재시도하세요.
  • 배치 작업은 rate limit 이하로 요청을 분산 처리하세요.
  • 월 사용량이 한도의 80%에 도달하면 계정 대표 이메일로 경고가 발송됩니다.