检查是否需要显示年龄验证门
返回某个司法管辖区对年龄验证的要求,以便在获知玩家年龄之前即可构建年龄验证界面。 请在玩家首次访问时调用。响应会说明是否必须展示年龄验证、该司法管辖区认定为关键的各个年龄、是否需要年龄保证,以及该地允许的年龄采集方式。
Authorization
api-key In: header
Query Parameters
玩家的管辖区域,可以是ISO 3166-1 alpha-2国家代码或ISO 3166-2分区代码。
^[A-z]{2}(-[A-z0-9]{1,3})?$提供年龄信号的平台。
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-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 } ]}{ "error": "INVALID_INPUT", "errorMessage": "Invalid jurisdiction"}检查年龄验证门 POST
执行年龄验证检查,判断玩家是否可以进入游戏,并在需要时创建年龄挑战。 请在提供玩家所在司法管辖区的同时,提供 `dateOfBirth`、`age` 或 `kuid` 中的且仅一个年龄信号。一个都不提供或提供多个都会导致请求无效。提供 `kuid` 时将使用监护人已登记的年龄,且生成的会话或挑战只会关联到该用户。 响应中的 `status` 决定接下来的操作:`PASS` 会返回会话,玩家可以继续;`CHALLENGE` 会返回需要先完成的挑战;`PROHIBITED` 两者都不返回,因为玩家未达到该产品的最低年龄。 返回挑战中的一次性密码会过期。请在准备展示时再调用 `/challenge/generate-otp`,并在挑战进入进行中状态之前定期重新生成。
获取类别对应的年龄范围 POST
将平台上报的年龄类别转换为其在指定司法管辖区所对应的年龄范围。 请提供司法管辖区,以及标明来源平台及其类别的 `platform` 年龄信号。由于各平台自行定义粗粒度的类别,k-ID 会将该类别映射为在该司法管辖区规则下玩家可能所处的年龄范围。