11件の投稿件のタグ「api」を含む

メール年齢推定のみを方式として年齢確認を実行するための専用エンドポイント /age-verification/perform-email-age-estimation が追加されました。これは、既存の単一方式エンドポイント（ID、AgeKey、ConnectID）と並ぶものです。

新機能​

• POST /age-verification/perform-email-age-estimation。 自動的な方式選択をバイパスし、メール年齢推定のみでユーザーを確認します。他の単一方式エンドポイントと同じリクエスト形式（jurisdiction、subject、criteria、および任意の options.redirectUrl / options.locale）を受け取り、id、url、shortUrl を返します。subject.email フィールドは任意です。省略した場合、ユーザーはホストされた確認ページでメールアドレスを入力します。
• 18歳以上のシグナル。 メール年齢推定は、正確な年齢推定ではなく18歳以上のシグナルです。対象者が18歳以上であることのみを確認でき、それより若い年齢帯を区別することはできないため、リクエストの基準をこの能力に合わせることはお客様の責任です。
• ステータスと結果は変更なし。 これまでどおり /age-verification/get-status をポーリングするか、Verification.Result webhook を処理してください。

ドキュメント​

• 単一方式の確認フロー
• 確認方式 → メールアドレス年齢推定

/session/delete can now permanently erase a session instead of only revoking it.

What's new​

• hardDelete on POST /session/delete. Set to true to permanently delete a player session and its embedded consent, scoped to the calling product. Unlike the default revoke (which is internally retained), this physically removes the record and can't be undone.
• Opt-in per developer. Available only to developers explicitly enabled for hard delete. Setting hardDelete: true without enablement returns FEATURE_DISABLED.
• Every existing call is unaffected. Omitting hardDelete, or setting it to false, behaves exactly as /session/delete always has: a reversible revoke.
• In-flight challenges are failed too. Any pending challenge tied to that exact session is set to FAIL, scoped to that session only (other sessions for the same player are untouched).

Documentation​

• /session/delete API reference

クレジットカードのみを方式として年齢確認を実行するための専用エンドポイント /age-verification/perform-credit-card-verification が追加されました。これは、既存の単一方式エンドポイント（ID、AgeKey、ConnectID）と並ぶものです。

新機能​

• POST /age-verification/perform-credit-card-verification。 自動的な方式選択をバイパスし、クレジットカードのみでユーザーを確認します。他の単一方式エンドポイントと同じリクエスト形式（jurisdiction、subject、criteria、および任意の options.redirectUrl / options.locale）を受け取り、id、url、shortUrl を返します。
• 成人（18歳以上）の保証。 クレジットカード確認は、正確な年齢推定ではなく成人であることの保証シグナルです。カードの所有が成人に限定されている法域に最も適しています。
• ステータスと結果は変更なし。 これまでどおり /age-verification/get-status をポーリングするか、Verification.Result webhook を処理してください。結果は確認 method として credit-card を報告します。

ドキュメント​

• /age-verification/perform-credit-card-verification APIリファレンス
• 単一方式の確認フロー
• 確認方式 → クレジットカード確認

/age-gate/check が、自動年齢保証チャレンジの完了後にk-IDが遷移するリダイレクトURLを受け入れるようになりました。これは、iframeベースの結果ハンドラーを使用できないトップレベルのブラウザハンドオフ（k-IDへ遷移して戻るモバイルwebviewなど）を想定したものです。

新機能​

• options.playerAgeAssurance.redirectUrl。 /age-gate/check に http(s) URLまたはカスタムスキームのモバイルディープリンク（例：myapp://age-gate/return）を渡します。プレイヤーが CHALLENGE_AGE_GATE_AGE_ASSURANCE フローを完了または閉じると、k-IDはそのURLに challengeId、productId、sessionId（PASS の場合）、status（PASS または FAIL）をクエリパラメータとして付加してリダイレクトします。URL上の既存のクエリパラメータは保持されます。
• スコープ。 このオプションは CHALLENGE_AGE_GATE_AGE_ASSURANCE に対してのみ有効です。CHALLENGE_PARENTAL_CONSENT は影響を受けず、引き続き信頼できる大人のフローを通じて返されます。
• 結果はサーバー側で確認してください。 リダイレクトのクエリパラメータはUXのヒントです。アクセスを許可する前に、Challenge.StateChange webhook または /challenge/get-status を信頼できる情報源として扱ってください。

ドキュメント​

• 年齢ゲート → チャレンジ後のリダイレクト
• /age-gate/check APIリファレンス
• Challenge.StateChange webhook

k-ID APIおよびユーザー向けの年齢確認・保護者同意フローのデフォルトレート制限を、専用ページに掲載しました。

新機能​

• APIレート制限。 k-ID APIへの呼び出しはプロダクト単位で制限されます：ライブモードでは500 RPS、テストモードでは10 RPS。制限を超えたリクエストはHTTP 429 Too Many Requestsを返します。
• 年齢確認および保護者同意フローのレート制限。 ユーザー向けフローはプロダクト単位で制限されます：ライブモードでは100 RPS、テストモードでは20 RPS。制限に達すると、ユーザーには「しばらく待ってから再試行してください」というインフロー上のエラーが表示されます（429はサーバーには通知されません）。
• 引き上げのリクエスト。 これらはデフォルトです。プロダクトでより高い容量が必要な場合は、k-IDの担当者にご連絡ください。
• ローンチ前チェックリストを更新。 ライブモードの上限値はテストモードと比べて大幅に高くなるため、CDKおよびAgeKit+のローンチ前チェックリストの両方で、レート制限を明示的に取り上げ、新しいページへリンクするようにしました。

ドキュメント​

• レート制限
• エラー処理
• CDKローンチ前チェックリスト
• AgeKit+ローンチ前チェックリスト

年齢確認を作成するエンドポイント（POST /age-verification/perform-access-age-verification やその他の perform-* 年齢確認ルートなど）のレスポンスに、id および url に加えて shortUrl が含まれるようになりました。

新機能​

• 短いリンク: shortUrl は、完全な url と同じ確認体験へリダイレクトする短いリンクです。クエリ文字列が長いと扱いにくい場合（QRコードや、ユーザーが別端末で確認を完了する場合など）に使えます。
• 完全なURLは従来どおり: セッションの JWT は引き続き完全な url の token クエリパラメータにあります。その URL を独自に短縮したり再構築したりしないでください。
• 不透明な値: shortUrl は不透明な文字列として扱い、返却されたとおりに表示・エンコードしてください。パスやクエリの形式は将来変わる可能性があるため、固定形式に依存しないでください。

詳しく見る​

• 年齢確認API（アクセス用）
• ウォーターフォーロー
• 年齢確認クイックスタート
• 単一方式フロー
• モバイルアプリ

Apple iOS、Google Play、Xbox、Meta Horizon、k-ID の年齢データが k-ID にどう取り込まれるか、年齢ゲートを表示しなくてよいケース、および 検証済み と 未検証 のシグナルが高リスク権限や年齢保証とどう関わるかを説明する、プラットフォーム年齢シグナル のエンドツーエンドドキュメントを公開しました。

新機能​

CDK — プラットフォーム年齢シグナル​

• プラットフォーム年齢シグナル — クイックな統合パス、API マップ、推奨リクエスト順、POST /age-gate/check でのプラットフォームシグナルの扱い、対応プラットフォームと 検証済みの declarationType、検証済みと未検証のシグナルの動作。
• プラットフォームシグナルの詳細 — プラットフォームごとのフィールド形、各ネイティブシグナルの取得方法、エンドポイント別の説明（get-requirements、check、get-default-permissions、session/get、get-platform-age-range、session/upgrade）、バリデーション、年齢の衝突、k-id シグナルのルール。

コンセプトと関連ドキュメント​

• 年齢シグナル — プラットフォーム年齢シグナルが他のシグナル種別とどう並ぶか、PlatformAgeSignal の統合詳細への参照先。
• 高リスク機能用の年齢保証 および 権限 — verifiedAgeThreshold と年齢ゲートでの検証済みプラットフォームシグナルに関する相互リンクの挙動。

API リファレンス（OpenAPI）​

セッションアップグレード、AgeVerification、platformAgeSignal の説明を、上記ドキュメントと揃えて 検証済みプラットフォームシグナル の表現に統一しました。

ドキュメント​

• プラットフォーム年齢シグナル
• プラットフォームシグナルの詳細
• 年齢シグナル
• 高リスク機能用の年齢保証
• 権限

Account System Product をリリースしました。組織の中央アカウントまたはプラットフォームプロダクトが、1 つの API キーとオプションのヘッダーを使用して、組織内の他のプロダクトに代わって認証チャレンジとセッションを作成できる機能です。

新機能​

Account System Product​

Compliance Studio でプロダクトを Account System Product として有効にすると、Kid-Target-Product-Id ヘッダーにターゲットプロダクトの ID を付けて、同じ組織内の他の（Account System Product 以外の）プロダクトに代わって特定の k-ID API を呼び出せます。Account System Product の API キーを使用するため、ターゲットごとのキー管理やローテーションは不要です。

対応エンドポイント:

• /age-gate/check
• /challenge/send-email
• /challenge/generate-otp

保護者はターゲットプロダクトの設定（通知、権限、ブランディング）のみを確認します。Account System Product とターゲットプロダクトの両方に、各イベントの Webhook が送信され、onBehalfOfProductId と initiatedByProductId でクロスプロダクトのフローを識別できます。

Account System Product は マルチプロダクト承認 と連携します。Account System Product をターゲットの必須プロダクトに設定すると、保護者が 1 回のフローで両方を承認できます。

ドキュメント​

• Account System Product – 実装ガイド、設定手順、Webhook ペイロード、セキュリティ

追加の法的リンク（Developer Details）と Check age gate API の options パラメータについてドキュメントを追加しました。同意フローでプラットフォーム別の法的文書（Xbox、PlayStation、Steam など）を表示できるようになります。

新機能​

追加の法的リンク（Developer Details）​

Compliance Studio のプロダクト 開発者の詳細 タブで、同意フローに表示される任意の 追加の法的リンク を追加できます。

• タイトルとリンク: ローカライズされた表示タイトルと URL（メインの法的文書と同じ言語オプション）。
• バリアント ID: Check age gate API 呼び出し時に使用する識別子（例: xbox-tos、playstation-privacy-policy）。常に表示がオフの場合は必須です。
• 常に表示: オン（デフォルト）の場合、同意フローで常にリンクが表示されます。オフの場合、ゲームが options で一致するバリアント ID を指定して年齢ゲート API を呼び出したときのみ表示されます。

ゲームが複数プラットフォームで配信され、プラットフォームごとに異なる法的文書 URL が必要な場合にご利用ください。

Check age gate API — options パラメータ​

POST /api/v1/age-gate/check のリクエストボディで、任意の options オブジェクトを指定できます。

• termsOfServiceDocument: 利用規約のバリアント ID（設定した追加の法的リンクと一致すること）。
• privacyPolicyDocument: プライバシーポリシーのバリアント ID（設定した追加の法的リンクと一致すること）。
• additionalLegalLinks: 利用規約およびプライバシーポリシーと一緒に表示する追加の法的文書のバリアント ID の配列（各 ID は設定した追加の法的リンクと一致すること）。

チャレンジが作成されると、同意画面ではプロダクトのデフォルトのプライバシーポリシー・利用規約ではなく、リクエストされた法的リンクが表示されます。

ドキュメント​

• 開発者の詳細 — 基本情報（追加の法的リンクを含む）
• Check age gate（リクエストボディと CheckAgeGateRequestOptions）

Age Gate WidgetエンドポイントにredirectUrlをオプションパラメータとして追加しました。

新機能​

Age Gate Widget API の更新​

/widget/generate-age-gate-urlエンドポイントは、optionsオブジェクト内にオプションのredirectUrlパラメータをサポートするようになりました。これにより、Age Gate Widget完了後にリダイレクトするURLを指定できます。これは、エンドツーエンドウィジェットエンドポイントと同様です。

redirectUrlパラメータは、HTTP/HTTPS URLまたはカスタムプロトコルスキームを使用したモバイルディープリンクをサポートします。

更新されたAPI​

• /widget/generate-age-gate-url