メインコンテンツに移動

年齢ゲート

年齢ゲートは、年齢制限のあるコンテンツ、機能、またはサービスへのアクセスを許可する前に、ユーザーの年齢を収集および確認するために使用されるメカニズムです。k-ID APIは、年齢ゲートを管理し、プレイヤーの年齢と管轄区域に基づいて必要なアクションを決定するエンドポイントを提供します。

年齢ゲート要件の取得​

プレイヤーの管轄区域で/age-gate/get-requirementsを呼び出して、以下を決定します：

  • 年齢ゲートを表示する必要があるかどうか（shouldDisplay）
  • 承認されている年齢収集方法（approvedAgeCollectionMethods）
  • 年齢閾値：
    • digitalConsentAge: プレイヤーがデジタル同意を提供できる最小年齢
    • civilAge: プレイヤーが法的成人と見なされる法的/契約年齢
    • minimumAge: プラットフォーム/ゲームにアクセスするために必要な最小年齢
  • 年齢保証が必要かどうか（ageAssuranceRequired）

リクエストの例​

GET /api/v1/age-gate/get-requirements?jurisdiction=US-CA
Authorization: Bearer your-api-key

レスポンスの例​

{
  "shouldDisplay": true,
  "ageAssuranceRequired": true,
  "digitalConsentAge": 13,
  "civilAge": 18,
  "minimumAge": 0,
  "approvedAgeCollectionMethods": [
    "date-of-birth",
    "age-slider",
    "platform-account"
  ]
}

アクセスのための年齢チェック​

プレイヤーの年齢を収集した後、生年月日と管轄区域で/age-gate/checkを呼び出して、次のステップを決定します：

  • PROHIBITED: プレイヤーの年齢がゲームの最小年齢未満です。プレイヤーは続行をブロックされる必要があります。
  • CHALLENGE: プレイヤーの年齢が検証可能な親の同意を必要とします。チャレンジが作成され、信頼できる大人によって承認される必要があります。
  • PASS: プレイヤーはゲームに続行できます。セッションが作成または返されます。

リクエストの例​

POST /api/v1/age-gate/check
Content-Type: application/json
Authorization: Bearer your-api-key

{
  "jurisdiction": "US-CA",
  "dateOfBirth": "2015-04-15"
}

CHALLENGEレスポンスの例​

{
  "status": "CHALLENGE",
  "challenge": {
    "challengeId": "683409f1-2930-4132-89ad-827462eed9af",
    "oneTimePassword": "ABC123",
    "type": "CHALLENGE_PARENTAL_CONSENT",
    "url": "https://family.k-id.com/authorize?otp=ABC123"
  }
}

PASSレスポンスの例​

{
  "status": "PASS",
  "session": {
    "sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
    "ageStatus": "LEGAL_ADULT",
    "dateOfBirth": "2005-04-15",
    "jurisdiction": "US-CA",
    "permissions": [...],
    "status": "ACTIVE"
  }
}

生年月日の形式​

生年月日の形式と要件の情報については、コアコンセプトセクションの年齢ゲートを参照してください。

デフォルト権限​

/age-gate/get-requirementsがshouldDisplay = falseで応答する場合、年齢ゲートを表示する必要はなく、プレイヤーの生年月日は定義されません。この場合、ゲームは/age-gate/get-default-permissionsを呼び出して管轄区域のデフォルト権限を取得することでSessionを作成します。これは、この管轄区域では年齢に基づいて権限が変わらないことを意味します。ゲーム内の一部の機能は、管轄区域に基づいてすべての年齢層に対して禁止される可能性があるため、ゲームは機能を有効にできるかどうかを確認するためにSession権限を参照する必要があります。