연령 게이트 표시 여부 확인
관할권이 연령 게이트에 요구하는 사항을 반환하므로, 플레이어의 연령을 알기 전에 게이트를 구성할 수 있습니다. 플레이어가 처음 접속했을 때 호출하십시오. 응답에는 게이트를 표시해야 하는지 여부, 해당 관할권에서 의미를 갖는 연령들, 연령 보증이 필요한지 여부, 그리고 승인된 연령 수집 방법이 포함됩니다.
Authorization
api-key In: header
Query Parameters
플레이어의 관할권으로, ISO 3166-1 alpha-2 국가 코드 또는 ISO 3166-2 세분화 코드입니다.
^[A-z]{2}(-[A-z0-9]{1,3})?$연령 신호를 제공하는 플랫폼.
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-requirements?jurisdiction=US-CA"{ "shouldDisplay": true, "ageAssuranceRequired": true, "digitalConsentAge": 13, "civilAge": 18, "minimumAge": 0, "effectiveMinimumAge": 0, "accessAge": 0, "approvedAgeCollectionMethods": [ "date-of-birth", "age-slider", "platform-account" ], "permissions": [ { "name": "loot-boxes-paid-gameplay-impacting", "verifiedAgeThreshold": 18 } ]}{ "error": "INVALID_INPUT", "errorMessage": "Invalid jurisdiction"}연령 게이트 확인 POST
연령 게이트 확인을 수행하여 플레이어가 게임에 입장할 수 있는지 판단하고, 필요한 경우 연령 챌린지를 생성합니다. 플레이어의 관할권과 함께 `dateOfBirth`, `age`, `kuid` 중 정확히 하나만 제공하십시오. 하나도 제공하지 않거나 둘 이상을 제공하면 잘못된 요청이 됩니다. `kuid`를 제공하면 보호자가 등록한 연령이 사용되며, 생성되는 세션 또는 챌린지는 해당 사용자에 연결됩니다. 응답의 `status`가 다음 동작을 결정합니다. `PASS`는 세션이 반환되어 플레이어가 계속 진행할 수 있음을 의미하고, `CHALLENGE`는 먼저 완료해야 하는 챌린지가 반환되었음을 의미하며, `PROHIBITED`는 플레이어가 제품의 최소 연령에 미달하여 둘 다 반환되지 않음을 의미합니다. 반환된 챌린지의 일회용 비밀번호는 만료됩니다. 표시할 준비가 된 시점에 `/challenge/generate-otp`를 호출하고, 챌린지가 진행 중이 될 때까지 주기적으로 다시 생성하십시오.
카테고리에 해당하는 연령 범위 가져오기 POST
플랫폼이 보고한 연령 카테고리를 특정 관할권에서 의미하는 연령 범위로 변환합니다. 관할권과 함께 출처 플랫폼 및 해당 카테고리를 나타내는 `platform` 연령 신호를 제공하십시오. 각 플랫폼은 자체적인 대략적 카테고리를 정의하므로, k-ID가 해당 카테고리를 그 관할권의 규칙에서 플레이어가 해당할 수 있는 연령 범위로 매핑합니다.