Endpoints年齢ゲート

デフォルト権限を取得する

保護者の同意が得られる前の状態で、プレイヤーがその管轄区域で既定で付与される権限を返します。 管轄区域とあわせて、`dateOfBirth`、`age`、`kuid` のうち最大1つを指定してください。複数を指定した場合は不正なリクエストになります。いずれも指定しない場合は、現在の日付をもとに年齢が算出されます。 何も保存されないため、年齢ゲートを実行する前にその管轄区域で何が許可されるかを確認する用途に適しています。

GET
/age-gate/get-default-permissions
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})?)?$
Formatdate
age?integer

プレイヤーの年齢(年単位)。

Range0 <= value <= 150
kuid?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}$
Formatuuid
platformName?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}$
Formatuuid

Response 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"    }  ]}