속도 제한
KnowledgePulse 레지스트리는 공정한 사용을 보장하고 서비스 안정성을 보호하기 위해 모든 엔드포인트에 계층 기반 속도 제한을 적용합니다.
응답 헤더
모든 속도 제한 응답에는 다음 헤더가 포함됩니다:
| 헤더 | 설명 |
|---|---|
X-RateLimit-Limit | 현재 윈도우에서 허용되는 최대 요청 수 |
X-RateLimit-Remaining | 현재 윈도우에서 남은 요청 수 |
X-RateLimit-Reset | 현재 윈도우가 리셋되는 Unix 타임스탬프(초) |
자동 키 취소
남용을 방지하기 위해, API 키가 1시간 윈도우 내에 3회 이상 429 응답을 트리거하면 레지스트리가 자동으로 취소합니다.
경고
자동 취소는 해당 키에 대해 영구적입니다. 이 임계값에 도달하지 않도록 적절한 백오프 로직을 구현하세요.
모범 사례
지수 백오프 구현
429 응답을 받으면 즉시 재시도하지 마세요. 지터가 포함된 지수 백오프를 사용하세요.
클라이언트 측 결과 캐시
응답을 로컬로 캐시하여 요청 수를 줄이세요. 지식 유닛과 스킬은 드물게 변경되므로 짧은 TTL(예: 5분)로도 요청 볼륨을 크게 줄일 수 있습니다.
효율적인 페이지네이션 사용
필요한 것만 가져오세요. limit과 offset 쿼리 매개변수를 사용하여 대규모 결과 세트를 요청하는 대신 결과를 페이징하세요.