デフォルト権限を取得する
保護者の同意が得られる前の状態で、プレイヤーがその管轄区域で既定で付与される権限を返します。 管轄区域とあわせて、`dateOfBirth`、`age`、`kuid` のうち最大1つを指定してください。複数を指定した場合は不正なリクエストになります。いずれも指定しない場合は、現在の日付をもとに年齢が算出されます。 何も保存されないため、年齢ゲートを実行する前にその管轄区域で何が許可されるかを確認する用途に適しています。
Authorization
api-key In: header
Query Parameters
プレイヤーの管轄区域。ISO 3166-1 alpha-2の国コードまたはISO 3166-2の細分区コードです。
^[A-z]{2}(-[A-z0-9]{1,3})?$プレイヤーの生年月日(YYYY-MM-DD形式)
^[0-9]{4}(-[0-9]{2}(-[0-9]{2})?)?$dateプレイヤーの年齢(年単位)。
0 <= value <= 150プレイヤーの既存のk-IDユーザーID。
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$uuid年齢シグナルを提供するプラットフォーム。
Value in
- "k-id"
- "meta-horizon"
- "apple-ios"
- "google-play"
- "xbox"
プラットフォームから報告される最小年齢(年単位)。
プラットフォームから報告される最大年齢(年単位)。
プラットフォーム固有の年齢カテゴリ(例: "digital-youth"、"13-15"、"teen")。
プラットフォームからの宣言タイプ(例: Apple AgeRangeDeclaration または Google userStatus)。
k-idプラットフォームシグナル用の検証ID。
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/age-gate/get-default-permissions?jurisdiction=US-CA"{ "ageStatus": "LEGAL_ADULT", "ageCategory": "adult", "requiresParentConsentForDataProcessing": true, "permissions": [ { "name": "text-chat-public", "enabled": false, "managedBy": "GUARDIAN" }, { "name": "text-chat-private", "enabled": true, "managedBy": "PLAYER" }, { "name": "forums", "enabled": false, "managedBy": "PROHIBITED" } ]}{ "error": "INVALID_INPUT", "errorMessage": "Invalid jurisdiction"}カテゴリに対応する年齢範囲を取得する POST
プラットフォームから提供された年齢カテゴリーを、指定した管轄区域で該当する年齢範囲に変換します。 管轄区域と、提供元プラットフォームおよびそのカテゴリーを示す `platform` の年齢シグナルを指定してください。各プラットフォームは独自の粗いカテゴリーを定義しているため、k-IDがそのカテゴリーを、当該管轄区域のルールにおいてプレイヤーが該当しうる年齢範囲に対応付けます。
セッションを削除する POST
セッションIDを指定してプレイヤーセッションを削除します。対象のセッションは呼び出し元のプロダクトに属している必要があります。 既定では論理削除です。セッションは revoked としてマークされ、以後クエリできなくなり、プレイヤーIDは再利用可能になりますが、レコード自体は保持されます。 **この操作は取り消せません。** `hardDelete` に `true` を指定した場合は、セッションとそれに含まれる同意情報を完全に削除します。元に戻すことはできません。ハード削除を明示的に有効化されたデベロッパーのみが利用できます。