기본 권한 가져오기
보호자 동의 이전 상태에서 플레이어가 해당 관할권에서 기본으로 받게 되는 권한을 반환합니다. 관할권과 함께 `dateOfBirth`, `age`, `kuid` 중 최대 하나를 제공하십시오. 둘 이상을 제공하면 잘못된 요청이 됩니다. 아무것도 제공하지 않으면 현재 날짜를 기준으로 연령을 계산합니다. 아무것도 저장되지 않으므로, 연령 게이트를 실행하기 전에 해당 관할권에서 무엇이 허용되는지 미리 확인하는 데 적합합니다.
Authorization
api-key In: header
Query Parameters
플레이어의 관할권으로, ISO 3166-1 alpha-2 국가 코드 또는 ISO 3166-2 세분화 코드입니다.
^[A-z]{2}(-[A-z0-9]{1,3})?$YYYY-MM-DD 형식의 플레이어 생년월일입니다.
^[0-9]{4}(-[0-9]{2}(-[0-9]{2})?)?$date연 단위의 플레이어 연령입니다.
0 <= value <= 150플레이어의 기존 k-ID 사용자 ID입니다.
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$uuid연령 신호를 제공하는 플랫폼.
Value in
- "k-id"
- "meta-horizon"
- "apple-ios"
- "google-play"
- "xbox"
플랫폼이 보고한 최소 연령(연 단위).
플랫폼이 보고한 최대 연령(연 단위).
플랫폼별 연령 카테고리(예: "digital-youth", "13-15", "teen").
플랫폼의 선언 유형(예: Apple AgeRangeDeclaration 또는 Google userStatus).
k-id 플랫폼 신호에 해당하는 확인 ID.
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/age-gate/get-default-permissions?jurisdiction=US-CA"{ "ageStatus": "LEGAL_ADULT", "ageCategory": "adult", "requiresParentConsentForDataProcessing": true, "permissions": [ { "name": "text-chat-public", "enabled": false, "managedBy": "GUARDIAN" }, { "name": "text-chat-private", "enabled": true, "managedBy": "PLAYER" }, { "name": "forums", "enabled": false, "managedBy": "PROHIBITED" } ]}{ "error": "INVALID_INPUT", "errorMessage": "Invalid jurisdiction"}카테고리에 해당하는 연령 범위 가져오기 POST
플랫폼이 보고한 연령 카테고리를 특정 관할권에서 의미하는 연령 범위로 변환합니다. 관할권과 함께 출처 플랫폼 및 해당 카테고리를 나타내는 `platform` 연령 신호를 제공하십시오. 각 플랫폼은 자체적인 대략적 카테고리를 정의하므로, k-ID가 해당 카테고리를 그 관할권의 규칙에서 플레이어가 해당할 수 있는 연령 범위로 매핑합니다.
세션 삭제 POST
세션 ID로 플레이어 세션을 삭제합니다. 대상 세션은 호출한 제품에 속해 있어야 합니다. 기본 동작은 논리 삭제입니다. 세션은 revoked로 표시되어 더 이상 조회되지 않고 플레이어 ID는 재사용할 수 있게 되지만, 레코드 자체는 보존됩니다. **되돌릴 수 없습니다.** `hardDelete`를 `true`로 지정하면 세션과 그 안에 포함된 동의 정보를 영구적으로 삭제하며, 이는 복구할 수 없습니다. 하드 삭제가 명시적으로 활성화된 개발자만 사용할 수 있습니다.