/api/v1/platform/* · /api/v1beta/platform/*)에는 조직(organization) 단위 요청 한도가 적용됩니다. 한도는 조직별로 따로 집계되므로, 한 조직의 트래픽이 다른 조직에 영향을 주지 않습니다.
경로 버전은 리소스마다 다릅니다. 한도는 버전과 무관하게 동일하게 적용됩니다. 버전과 호환성을 참고하세요.
한도
한도는 1초 고정 윈도우로 집계됩니다. 매 초가 시작될 때 카운터가 초기화됩니다.
응답 헤더
Rate Limit이 적용된 모든 응답에는 현재 윈도우의 상태가 헤더로 포함됩니다.한도 초과 응답
한도를 초과하면 API는429 Too Many Requests와 함께 다음 본문을 반환합니다.
Retry-After 헤더에 담긴 초만큼 기다린 뒤 다시 요청하세요.
한도에 맞춰 요청하기
1
남은 요청 수 확인
응답의
X-RateLimit-Remaining 값으로 현재 윈도우에 보낼 수 있는 요청이 얼마나 남았는지 확인합니다.2
429 응답 처리
429 응답을 받으면 Retry-After 헤더의 초만큼 대기한 뒤 재시도합니다.3
대량 작업은 분산
많은 요청을 보내야 한다면 초당 한도에 맞춰 간격을 두고 나눠 보냅니다.