Endpoints연령 게이트

연령 게이트 표시 여부 확인

관할권이 연령 게이트에 요구하는 사항을 반환하므로, 플레이어의 연령을 알기 전에 게이트를 구성할 수 있습니다. 플레이어가 처음 접속했을 때 호출하십시오. 응답에는 게이트를 표시해야 하는지 여부, 해당 관할권에서 의미를 갖는 연령들, 연령 보증이 필요한지 여부, 그리고 승인된 연령 수집 방법이 포함됩니다.

GET
/age-gate/get-requirements
AuthorizationBearer <token>

In: header

Query Parameters

jurisdiction*string

플레이어의 관할권으로, ISO 3166-1 alpha-2 국가 코드 또는 ISO 3166-2 세분화 코드입니다.

Match^[A-z]{2}(-[A-z0-9]{1,3})?$
platformName?string

연령 신호를 제공하는 플랫폼.

Value in

  • "k-id"
  • "meta-horizon"
  • "apple-ios"
  • "google-play"
  • "xbox"
platformAgeLow?integer

플랫폼이 보고한 최소 연령(연 단위).

platformAgeHigh?integer

플랫폼이 보고한 최대 연령(연 단위).

platformCategory?string

플랫폼별 연령 카테고리(예: "digital-youth", "13-15", "teen").

platformDeclarationType?string

플랫폼의 선언 유형(예: Apple AgeRangeDeclaration 또는 Google userStatus).

platformVerificationId?string

k-id 플랫폼 신호에 해당하는 확인 ID.

Match^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$
Formatuuid

Response 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    }  ]}

연령 게이트 확인 POST

연령 게이트 확인을 수행하여 플레이어가 게임에 입장할 수 있는지 판단하고, 필요한 경우 연령 챌린지를 생성합니다. 플레이어의 관할권과 함께 `dateOfBirth`, `age`, `kuid` 중 정확히 하나만 제공하십시오. 하나도 제공하지 않거나 둘 이상을 제공하면 잘못된 요청이 됩니다. `kuid`를 제공하면 보호자가 등록한 연령이 사용되며, 생성되는 세션 또는 챌린지는 해당 사용자에 연결됩니다. 응답의 `status`가 다음 동작을 결정합니다. `PASS`는 세션이 반환되어 플레이어가 계속 진행할 수 있음을 의미하고, `CHALLENGE`는 먼저 완료해야 하는 챌린지가 반환되었음을 의미하며, `PROHIBITED`는 플레이어가 제품의 최소 연령에 미달하여 둘 다 반환되지 않음을 의미합니다. 반환된 챌린지의 일회용 비밀번호는 만료됩니다. 표시할 준비가 된 시점에 `/challenge/generate-otp`를 호출하고, 챌린지가 진행 중이 될 때까지 주기적으로 다시 생성하십시오.

카테고리에 해당하는 연령 범위 가져오기 POST

플랫폼이 보고한 연령 카테고리를 특정 관할권에서 의미하는 연령 범위로 변환합니다. 관할권과 함께 출처 플랫폼 및 해당 카테고리를 나타내는 `platform` 연령 신호를 제공하십시오. 각 플랫폼은 자체적인 대략적 카테고리를 정의하므로, k-ID가 해당 카테고리를 그 관할권의 규칙에서 플레이어가 해당할 수 있는 연령 범위로 매핑합니다.