요청 제한

API 요청 제한을 이해하고 올바르게 처리하기.

제한 정책

API 키 하나당 초당 최대 10회 요청할 수 있습니다 (토큰 버킷 10, 매초 리필). 제한은 키 단위이며 모든 엔드포인트에 합산 적용됩니다.

요청 제한 헤더

모든 응답에 현재 제한 상태가 포함됩니다:

헤더의미
X-RateLimit-Limit초당 요청 한도 (10)
X-RateLimit-Remaining현재 윈도우에서 남은 요청 수
X-RateLimit-Reset윈도우 리셋 시각 (Unix epoch 초)

한도를 초과하면

API가 **429 Too Many Requests**를 반환합니다:

{
  "errorCode": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

복구: 1초간 요청을 멈춘 뒤 재개하세요. 대량 발송(예: 수천 건의 리워드)에는 429에 반응하기보다 처음부터 클라이언트를 초당 10회 아래로 조절하는 방식을 권장합니다 — 요청 간 100ms 이상 간격을 두는 단순한 큐면 충분합니다.

📘

출시나 캠페인을 위해 더 높은 한도가 필요하신가요? [email protected]으로 문의하세요.


Did this page help you?