Endpoints年龄验证门

检查是否需要显示年龄验证门

返回某个司法管辖区对年龄验证的要求,以便在获知玩家年龄之前即可构建年龄验证界面。 请在玩家首次访问时调用。响应会说明是否必须展示年龄验证、该司法管辖区认定为关键的各个年龄、是否需要年龄保证,以及该地允许的年龄采集方式。

GET
/age-gate/get-requirements
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})?$
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-requirements?jurisdiction=US-CA"
{  "shouldDisplay": true,  "ageAssuranceRequired": true,  "digitalConsentAge": 13,  "civilAge": 18,  "minimumAge": 0,  "effectiveMinimumAge": 0,  "accessAge": 0,  "approvedAgeCollectionMethods": [    "date-of-birth",    "age-slider",    "platform-account"  ],  "permissions": [    {      "name": "loot-boxes-paid-gameplay-impacting",      "verifiedAgeThreshold": 18    }  ]}