カスタム年齢ゲート

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

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

<div id="age-gate">
  <h2>生年月日を入力してください</h2>
  <form id="age-gate-form">
    <label for="dob">生年月日</label>
    <input type="date" id="dob" name="dob" required />
    <button type="submit">続行</button>
  </form>
</div>

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

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

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

{
  "jurisdiction": "US-CA",
  "age": 9
}

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

{
  "jurisdiction": "US-CA",
  "dateOfBirth": "2005-04-15",
  "platformAgeSignal": {
    "name": "apple-ios",
    "ageLow": 18,
    "ageHigh": 25,
    "declarationType": "governmentIDChecked"
  }
}

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

{
  "status": "PROHIBITED"
}

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

{
  "status": "CHALLENGE",
  "challenge": {
    "challengeId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "CHALLENGE_AGE_GATE_AGE_ASSURANCE",
    "url": "https://family.k-id.com/age-gate/verify?token=..."
  }
}

POST /api/v1/challenge/send-email
Content-Type: application/json
Authorization: Bearer your-api-key

{
  "challengeId": "683409f1-2930-4132-89ad-827462eed9af",
  "email": "parent@example.com"
}

// チャレンジURLからQRコードを生成
const qrCodeUrl = challenge.url;
// QRコードライブラリを使用してレンダリング: "https://family.k-id.com/authorize?otp=PP5BUS"

<div id="challenge-screen">
  <h2>信頼できる大人に助けを求めてください</h2>
  <p>
    以下のいずれかの方法で、信頼できる大人にセットアップを完了してもらってください。
  </p>

  <div class="options-container">
    <!-- オプション1：メール -->
    <div class="option">
      <h3>オプション1</h3>
      <p>信頼できる大人のメールアドレスを入力</p>
      <form id="email-form">
        <label for="email">メール</label>
        <input type="email" id="email" placeholder="メールアドレス" required />
        <button type="submit">送信</button>
      </form>
    </div>

    <!-- オプション2：QRコード -->
    <div class="option">
      <h3>オプション2</h3>
      <p>
        信頼できる大人にQRコードをスキャンまたはクリックしてもらってください。
      </p>
      <div id="qr-code">
        <!-- challenge.urlからQRコードをレンダリング -->
      </div>
    </div>

    <!-- オプション3：手動コード -->
    <div class="option">
      <h3>オプション3</h3>
      <p>
        <a href="https://asktoplay.com">asktoplay.com</a
        >にアクセスし、以下のコードを入力してください。
      </p>
      <div class="code-display">
        <span id="otp-code">PP5BUS</span>
        <button onclick="copyCode()">コピー</button>
      </div>
    </div>
  </div>

  <button id="do-later">後で行う</button>
</div>

// チャレンジ作成時に保存（localStorageを使用した例）
localStorage.setItem("pendingChallenge", challengeId);

// アプリ再起動時に保留中のチャレンジを確認
const pendingChallenge = localStorage.getItem("pendingChallenge");
if (pendingChallenge) {
  // チャレンジの詳細を取得してチャレンジ画面を表示
  const challenge = await fetchChallenge(pendingChallenge);
  showChallengeScreen(challenge);
}

<iframe
  id="age-assurance-widget"
  src="CHALLENGE_URL"
  width="100%"
  height="600"
  frameborder="0"
  allow="camera;payment;publickey-credentials-get;publickey-credentials-create">
</iframe>

window.addEventListener("message", (event) => {
  if (!event.origin.endsWith(".k-id.com")) {
    return;
  }

  const message = event.data;
  if (message?.eventType === "Verification.Result") {
    if (message.data.status === "PASS") {
      // プレイヤーが正常に検証されました。
      // セッションが作成中です - sessionId を取得するには
      // Challenge.StateChange Webhook を待つか /challenge/get-status をポーリングします。
      closeAgeAssuranceIframe();
    } else if (message.data.status === "FAIL") {
      // プレイヤーが年齢基準を満たしていません。セッションは作成されません。
      closeAgeAssuranceIframe();
      showVerificationFailedMessage();
    }
  }
});

{
  "eventType": "Challenge.StateChange",
  "data": {
    "id": "683409f1-2930-4132-89ad-827462eed9af",
    "productId": 42,
    "status": "PASS",
    "dob": "2015-04-15",
    "sessionId": "0ad1641f-c154-4c2-8bb2-74dbd0de7723",
    "approverEmail": "parent@example.com",
    "kuid": "7a1f2c3d-4e5f-6789-abcd-ef0123456789"
  }
}

GET /api/v1/session/get?id=0ad1641f-c154-4c2-8bb2-74dbd0de7723
Authorization: Bearer your-api-key

{
  "session": {
    "ageStatus": "DIGITAL_MINOR",
    "dateOfBirth": "2015-04-15",
    "etag": "6d9d24fccd428f845b355122799948dd0a52fc5d",
    "jurisdiction": "US-CA",
    "kuid": "7a1f2c3d-4e5f-6789-abcd-ef0123456789",
    "permissions": [
      {
        "enabled": true,
        "managedBy": "GUARDIAN",
        "name": "text-chat-private"
      },
      {
        "enabled": false,
        "managedBy": "GUARDIAN",
        "name": "voice-chat"
      }
    ],
    "sessionId": "0ad1641f-c154-4c2-8bb2-74dbd0de7723",
    "status": "ACTIVE"
  },
  "status": "PASS"
}

// 保留中のチャレンジをクリアしてアクティブなセッションを保存
user.challengeId = null;
user.sessionId = data.sessionId;

{
  "eventType": "Session.Delete",
  "data": {
    "id": "0ad1641f-c154-4c2-8bb2-74dbd0de7723",
    "productId": 42
  }
}

app.post("/webhook/k-id", (req, res) => {
  const { eventType, data } = req.body;

  switch (eventType) {
    case "Challenge.StateChange":
      if (data.status === "PASS") {
        // アクセスを許可 - ユーザーのsessionIdを保存
        grantAccess(data.sessionId, data.kuid);
      } else if (data.status === "FAIL") {
        // アクセスを拒否
        denyAccess(data.id);
      }
      break;

    case "Session.Delete":
      // アクセスを取り消し - ユーザーは再度年齢ゲートを完了する必要がある
      revokeSession(data.id);
      break;
  }

  res.status(200).send("OK");
});

GET /api/v1/challenge/get-status?id=683409f1-2930-4132-89ad-827462eed9af
Authorization: Bearer your-api-key