속도 제한
k-ID 플랫폼은 두 가지 독립적인 속도 제한을 적용합니다:
- API 속도 제한은 서버에서 k-ID API로의 직접 호출에 적용됩니다. 제한을 초과하면 요청은 HTTP
429 Too Many Requests로 실패합니다. - 연령 확인 및 보호자 동의 흐름 속도 제한은 사용자 대상 흐름(연령 확인 위젯 및 VPC Challenge)에 적용됩니다. 제한을 초과하면 사용자에게 잠시 기다렸다가 다시 시도하라는 흐름 내 오류가 표시됩니다.
두 가지 제한 모두 라이브 모드와 테스트 모드 간에 다르며, 모두 제품별로 적용됩니다.
API 속도 제한
k-ID API 호출은 제품별로 속도 제한됩니다. 제한을 초과하는 요청은 응답 본문이 없는 HTTP 429 응답을 받습니다.
| 모드 | 기본 제한 |
|---|---|
| 라이브 모드 | 500 RPS |
| 테스트 모드 | 10 RPS |
429 응답 처리
429를 받으면 통합에서 다음을 수행해야 합니다:
- 짧은 쿨다운 기간 동안 새 요청 전송을 중지합니다.
- 빠듯한 재시도 루프 대신 지터를 포함한 지수 백오프로 재시도합니다.
- 가능한 경우 응답을 캐시합니다(예: 세션 및 연령 게이트 요구 사항).
- 동일한 리소스에 대한 중복된 동시 요청을 통합합니다.
HTTP 상태 코드 및 오류 형식의 전체 목록은 오류 처리를 참조하세요.
연령 확인 및 보호자 동의 흐름 속도 제한
호스팅된 위젯 URL 및 Challenge 흐름을 포함한 사용자 대상 연령 확인 및 보호자 동의 흐름은 직접 API 호출과 별도로 속도 제한됩니다. 이러한 제한 또한 제품별로 적용됩니다.
| 모드 | 기본 제한 |
|---|---|
| 라이브 모드 | 100 RPS |
| 테스트 모드 | 20 RPS |
이 제한을 초과하면 사용자에게 잠시 기다렸다가 다시 시도하라는 흐름 내 오류가 표시됩니다. 429는 서버에 표시되지 않습니다. 이 제한은 이전 섹션에 설명된 API 속도 제한과 독립적이며 추가로 적용됩니다. 단일 사용자 여정이 두 버킷의 용량을 모두 소비할 수 있습니다.
기본 제한 및 제한 상향 요청
더 높은 제한이 필요하신가요?
이 페이지의 수치는 모든 제품에 할당되는 기본 속도 제한입니다. 제품에 더 높은 용량이 필요한 경우(예: 출시, 마케팅 캠페인 또는 지속적인 트래픽 증가) k-ID 담당자에게 연락하여 제한 상향을 요청하세요.