속도 제한

속도 제한은 테넌트 성능을 예측 가능하게 유지합니다. 고정된 60초 윈도에 걸쳐 API 키별로 적용됩니다.

등급

등급	분당 요청 수
`standard`(기본값)	120
`elevated`	600

키의 등급과 현재 예산은 GET /v1/auth/context(rate_limit_tier)와 GET /v1/usage(rate_limit.limit_per_minute 및 rate_limit.remaining_per_minute)에서 보고됩니다. 값을 하드코딩하지 말고 항상 실시간 값을 읽으세요.

제한을 초과할 때

제한을 초과한 요청은 code: "RATE_LIMITED"와 함께 429를 반환합니다. 윈도가 재설정된 후 백오프하고 재시도하세요.

제한 내에서 설계하기

참조 데이터를 캐시하고 전체 테이블 폴링보다 증분 동기화를 선호하세요.
폴링 대신 이벤트 기반 업데이트를 위해 웹훅을 사용하세요.
429에서 백오프하고 일시적 실패 후 병렬 재시도 폭주를 피하세요.
필터(search, status, module)를 결합하여 더 적게 가져오세요.

속도 제한

속도 제한은 테넌트 성능을 예측 가능하게 유지합니다. 고정된 60초 윈도에 걸쳐 API 키별로 적용됩니다.

등급

등급	분당 요청 수
`standard`(기본값)	120
`elevated`	600

제한을 초과할 때

제한을 초과한 요청은 code: "RATE_LIMITED"와 함께 429를 반환합니다. 윈도가 재설정된 후 백오프하고 재시도하세요.

제한 내에서 설계하기

참조 데이터를 캐시하고 전체 테이블 폴링보다 증분 동기화를 선호하세요.
폴링 대신 이벤트 기반 업데이트를 위해 웹훅을 사용하세요.
429에서 백오프하고 일시적 실패 후 병렬 재시도 폭주를 피하세요.
필터(search, status, module)를 결합하여 더 적게 가져오세요.