요청 속도 제한
Engine ≥ 4.143.0. 각 토큰 응답에는 발급 당시 스토어 정책의 data.rate_limits가 포함됩니다. 모든 키가 이 한도를 공유하며 새 토큰을 받아도 초기화되지 않습니다. 요금제 변경은 토큰 만료 전에 적용될 수 있습니다.
- read_per_minute
- 분당 읽기 요청 수입니다.
- write_per_minute
- 분당 쓰기 요청 수입니다. 이 값은 쓰기 권한을 부여하지 않습니다.
- auth_per_minute
- 인증 실패를 포함한 분당 토큰 요청 수입니다.
요청을 일정한 간격으로 보내세요. 읽기 한도가 양수이면 읽기 요청 사이에 최소 60 / read_per_minute초를 두세요. 한도가 해당 수의 동시 요청을 보장하지는 않습니다. 다른 연동도 공유하므로 429와 Retry-After를 처리하세요.
0은 무제한이 아니라 사용할 수 없음을 뜻합니다.
분당 한도
| 최소 요금제 | 읽기 · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- 쓰기
- 10
- 인증
- 10
동일한 스토어에 속한 모든 키가 이 제한을 공유합니다.
요청
- 읽기와 쓰기 트래픽에는 스토어의 현재 API 정책이 적용됩니다.
- 키마다 별도의 무제한 처리 용량이 주어지는 것은 아닙니다.
- 동시 실행을 제한하고 적절한 참조 데이터를 캐시하며 변하지 않은 상세 레코드를 반복 조회하지 마세요.
429 · Retry-After
- API가 429 와 rate_limit.exceeded 를 반환하면 Retry-After 에 명시된 초 이상 기다린 후 무작위 지연을 더해 재시도하세요.
- 429 · capacity.queue_full — API의 짧은 대기열이 가득 찼습니다. 요청 실행은 시작되지 않았습니다. 429 · capacity.wait_timeout — API 대기열의 대기 시간이 초과되었습니다. 요청 실행은 시작되지 않았습니다. 최소 Retry-After 초를 기다리고 무작위 지연을 추가하세요. 쓰기 재시도 시 원래 키와 내용을 유지하세요.
- 고정 재시도 간격을 추측하지 말고 문서화된 오류 코드와 헤더를 사용하세요.