속도 제한

요청 속도

한도는 API key마다 적용되며, 구체적인 수치는 워크스페이스 요금제가 정합니다. key에는 초당 한도(1초 슬라이딩 윈도)와 UTC 자정에 초기화되는 일일 할당량이 있습니다. 대시보드 세션에는 속도 제한이 적용되지 않습니다.

스코프나 모듈이 없어 거부된 요청(403)은 집계되지 않습니다. 인증을 통과한 요청은 결과와 관계없이 모두 집계됩니다.

헤더

속도 제한을 통과한 모든 응답에는 남은 한도가 포함됩니다. X-RateLimit-Limit와 X-RateLimit-Remaining은 초당 윈도를 나타내며, Daily 헤더 쌍은 key에 일일 할당량이 있을 때 표시됩니다.

HTTP/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431

429 응답의 형태

제한된 요청은 429와 코드 rate_limit_exceeded, 표준 오류 형식, 그리고 초 단위 정수로 된 Retry-After 헤더를 반환합니다. 최소한 그 시간만큼 기다린 뒤 재시도하고, 다시 제한되면 지수적으로 백오프하세요.

HTTP/2 429Content-Type: application/jsonRetry-After: 1 {"code":"rate_limit_exceeded","message":"API key rate limit exceeded.","requestId":"3f2b6c1e-…","retryable":true}

일일 할당량을 모두 사용하면 429와 코드 daily_quota_exceeded, 그리고 UTC 자정까지 남은 시간을 나타내는 Retry-After를 반환합니다. 429 응답 자체에는 할당량 헤더가 포함되지 않습니다.

크레딧

요청 속도와는 별개로, 모든 조회는 워크스페이스 지갑의 크레딧으로 측정됩니다. 캐시 조회는 저렴하고, 새 데이터를 수집하는 요청은 더 많은 크레딧이 듭니다(크레딧 참고). 한도에 도달하면 캐시 조회를 포함한 모든 과금 대상 호출이 402와 코드 credit_cap_exceeded를 반환합니다.