Docs
Status
Supportk-id.comCompliance Studio
Endpoints연령 게이트

연령 게이트 확인

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

POST
/age-gate/check

Authorization

api-key
AuthorizationBearer <token>

In: header

Header Parameters

Kid-Target-Product-Id?integer

Optional header for Account System Products to perform cross-product age gate checks. The value must be the product ID of the target product within the same organization. The target product must not itself be an Account System Product.

Request Body

application/json

연령 게이트 확인

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/age-gate/check" \  -H "Content-Type: application/json" \  -d '{    "jurisdiction": "US-CA",    "dateOfBirth": "2012-06-15",    "age": 13,    "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d",    "platformAgeSignal": {      "name": "meta-horizon",      "category": "TN"    },    "subject": {      "id": "id-12345678-1234-1234-1234-123456789012"    },    "options": {      "termsOfServiceDocument": "xbox-tos",      "privacyPolicyDocument": "xbox-privacy-policy",      "additionalLegalLinks": [        "steam-tos",        "xbox-conduct"      ],      "playerAgeAssurance": {        "redirectUrl": "https://example.com/verify/complete"      }    }  }'

{  "status": "PASS",  "session": {    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",    "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d",    "ageStatus": "LEGAL_ADULT",    "ageCategory": "adult",    "etag": "e889efb9e8a985308e82bed78c5aef7f37f50cf36b7337bf654980d0bab7a574",    "status": "ACTIVE",    "dateOfBirth": "2005-04-15",    "jurisdiction": "US-CA",    "managedBy": "PLAYER",    "permissions": [      {        "name": "text-chat-public",        "enabled": false,        "managedBy": "GUARDIAN"      },      {        "name": "text-chat-private",        "enabled": true,        "managedBy": "PLAYER"      },      {        "name": "forums",        "enabled": false,        "managedBy": "PROHIBITED"      }    ]  }}

연령 카테고리 확인 POST

세션이나 챌린지를 생성하지 않고, 생년월일 또는 연령으로부터 플레이어의 관할권에 해당하는 연령 카테고리를 확인합니다. 연령 게이트 판단 전체가 아니라 카테고리만 필요할 때(예: 제품 동작을 분기할 때) 사용하십시오.

연령 게이트 표시 여부 확인 GET

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