Endpoints年齢ゲート
デフォルト権限を取得する
保護者の同意が得られる前の状態で、プレイヤーがその管轄区域でデフォルトで付与される権限を返します。 管轄区域とあわせて、`dateOfBirth`、`age`、`kuid` のうち最大1つを指定してください。複数を指定した場合は不正なリクエストになります。いずれも指定しない場合は、現在の日付をもとに年齢が算出されます。 何も保存されないため、年齢ゲートを実行する前にその管轄区域で何が許可されるかを確認する用途に適しています。
Authorization
api-key AuthorizationBearer <token>
In: header
Query Parameters
jurisdiction*string
プレイヤーの管轄区域。ISO 3166-1 alpha-2の国コードまたはISO 3166-2の細分区コードです。
Match
^[A-z]{2}(-[A-z0-9]{1,3})?$dateOfBirth?string
プレイヤーの生年月日(YYYY-MM-DD形式)
Match
^[0-9]{4}(-[0-9]{2}(-[0-9]{2})?)?$Format
dateage?integer
プレイヤーの年齢(年単位)。
Range
0 <= value <= 150kuid?string
プレイヤーの既存のk-IDユーザーID。
Match
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$Format
uuidplatformName?string
年齢シグナルを提供するプラットフォーム。
Value in
- "k-id"
- "meta-horizon"
- "apple-ios"
- "google-play"
- "xbox"
platformAgeLow?integer
プラットフォームから報告される最小年齢(年単位)。
platformAgeHigh?integer
プラットフォームから報告される最大年齢(年単位)。
platformCategory?string
プラットフォーム固有の年齢カテゴリ(例: "digital-youth"、"13-15"、"teen")。
platformDeclarationType?string
プラットフォームからの宣言タイプ(例: Apple AgeRangeDeclaration または Google userStatus)。
platformVerificationId?string
k-idプラットフォームシグナル用の検証ID。
Match
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$Format
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"}