속도 제한 및 할당량

속도 제한은 특정 통합이 다른 사용자의 성능을 저하시키지 않도록 방지합니다. Management API에서는 자격 증명별로, 퍼블릭 API에서는 사이트, 방문자 또는 고객별로 제한이 계산됩니다. 할당량은 이와 다르며, 컬렉션 항목이나 Webhook 엔드포인트와 같이 사이트가 저장할 수 있는 리소스의 양을 제한하며 플랜에 따라 달라집니다.

제한에 도달한 경우

API는 429 상태 코드와 RATE_LIMITED 코드, 그리고 Retry-After 헤더(초 단위)를 반환합니다. 해당 시간만큼 대기한 후 백오프를 적용하여 재시도하십시오.

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests.",
    "details": { "retryAfter": 12 }
  }
}

백엔드가 혼잡할 때는 SEARCH_BUSY 또는 ANALYTICS_BUSY와 같이 더 구체적인 코드와 함께 429가 반환될 수 있습니다. 이 경우에도 동일한 방식으로 처리하십시오.

Management API

각 토큰에는 고유한 예산이 할당됩니다. 대부분의 작업은 기본 계층을 공유합니다. 분석 쿼리는 부하가 크기 때문에 토큰별로 더 낮은 계층이 적용되며, 사이트별로 상한선이 있어 해당 사이트의 모든 토큰이 이를 공유합니다. REST 및 MCP 호출은 동일한 예산에서 차감됩니다.

Management API 참조의 각 작업에는 계층이 표시되어 있으며, OpenAPI 문서에는 x-kanorio-rate-limit로 기재되어 있습니다.

Content Delivery API

엣지 캐시에서 제공되는 응답은 계산되지 않으므로, 캐시가 활성화된 혼잡한 사이트는 이러한 제한에 도달하지 않습니다. 캐시 미스, 폼 작성, 분석 비콘, 초안 미리보기는 토큰 버킷에서 계산됩니다. 각 버킷은 일정한 속도로 다시 채워지며 짧은 버스트를 허용합니다. 계산되는 응답에는 다음 헤더가 포함됩니다.

가능한 경우 서버 측이나 빌드 시점에 페이지를 구축하여 엣지 캐시가 방문자 트래픽을 처리하도록 하십시오.

Customer API

로그인 후 호출은 고객 토큰별로 제한됩니다. 로그인 요청은 IP 주소별로 제한됩니다.

현재 제한 및 할당량

아래 값은 API가 적용하는 동일한 상수에서 생성되었습니다.

Management API tiers

Content Delivery API buckets

Cache hits are not counted. Only requests that miss the edge cache, form writes and analytics beacons use these buckets.

Customer API buckets

Plan quotas