年龄验证API:哪种适用于应用、网页与应用商店
五类年龄验证API及其适用场景:Play应用、App Store应用、侧载应用、网页与桌面端。涵盖自拍API调用、托管会话、Webhook校验、成本与数据处理。

简而言之
没有任何单一的年龄验证 API 能覆盖所有平台环境。应用商店和操作系统的 API 仅在其自身应用内响应,[1][5] 因此网页端、侧载版本和大多数桌面应用都需要您自行运行核验,例如自拍年龄估算,并在临界情况下辅以证件核验步骤。
- Play 应用或 iOS 应用:先请求商店或系统信号,若已满足要求便可在此停止。
- 网页端、侧载、其他商店、桌面端:只要有摄像头,自拍或证件 API 即可在任何地方工作。
- 将商店信号与您自己的核验结果分开保存:约束它们的条款有所不同。
搜索“age verification API”(年龄验证 API),您会在同一个名称下得到五种不同的产品:商店信号、电信运营商查询、钱包凭证、人脸估算和证件核验。本指南按您用户所在的平台环境对它们进行分类,随后展示具体的调用方式。
关于 2027 年 1 月有哪些变更,请阅读 Google Play Age Signals API 指南。请与法律顾问确认哪项年龄规则适用于您的应用。
简明答案:从平台环境出发
1明确您设限的功能
一项功能,一个最低年龄要求,以及运行的国家或地区。没有任何年龄限制内容的应用可能无需进行任何自身的核验。
用户正在使用从具有年龄 API 的应用商店安装的应用
请求商店或系统
如果其返回响应且您的规则接受该响应,则在此停止。
转入您自己的核验流程
网页端、侧载、桌面端、不受支持的设备或旧版系统版本。
2仅在需要的地方运行您自己的核验
先进行自拍估算,对阈值临界区间进行证件核验。
五类年龄验证 API
它们在由谁核实年龄以及返回的内容上存在差异。
| 类别 | 示例 | 返回内容 | 依据基础 |
|---|---|---|---|
| 商店或操作系统信号 | Google Play Age Signals、Apple Declared Age Range、Amazon GetUserAgeData、Samsung Get Age Signals | 年龄区间;Google 和 Apple 还会说明其设定方式,且不提供出生日期 | 账户持有者、家长或应用商店记录的信息。Google 的 TIER_A 表示年龄由用户自行提供,且 Google“可能核实了也可能未核实此信息”[2] |
| 电信查询 | CAMARA Know Your Customer Age Verification | ageCheck:true、false 或 not_available[10] | 运营商的订户记录;API 状态为 Initial,可用性取决于国家和网络[10] |
| 钱包或 eID | 国家 eID,欧盟年龄核验解决方案 | 达到特定年龄的证明,或出生日期 | 签发方的记录,适用于持有者 |
| 自拍估算 | Didit POST /v3/age-estimation/ | 以岁为单位的估算年龄和活体检测分数 | 模型读取人脸;它无法指明该人的身份 |
| 证件核验 | Didit POST /v3/id-verification/ 或工作流步骤 | 从证件中读取的出生日期、年龄和签发州/国家[19] | 政府签发的证件,若添加了相应环节,还包含活体检测和人脸比对步骤 |
欧盟解决方案允许个人在不共享其他个人数据的情况下证明自己年满 18 岁,并可适用于其他年龄。[11]
如需了解权衡考量,请参阅eID 与年龄估算的对比。
覆盖范围表:各个 API 在哪些平台上提供响应
| API | Google Play 应用 | App Store 应用 | 侧载及其他 Android 应用商店 | 网页端 | 桌面端 |
|---|---|---|---|---|---|
| Play Age Signals | 是,Android 6.0 及以上版本,前提是 Google Play 更新了该应用[1][27] | 否 | 否:当 Play 未安装该应用时返回 APP_NOT_OWNED[3] | 未记录 Web 调用 | 否;不受支持的设备类型返回 DEVICE_NOT_SUPPORTED[3] |
| Apple Declared Age Range | 否 | 是,iOS 和 iPadOS 26.0 及以上版本[5] | 否 | 未记录 Web 调用 | 仅限 Mac:macOS 26.0 及以上版本[5][6] |
| Amazon GetUserAgeData | 否 | 否 | 仅限 Amazon Appstore 安装,适用于该页面涵盖的美国各州中符合资格的账户[8] | 否 | 否 |
| Samsung Get Age Signals | 否 | 否 | 仅限 Galaxy Store 安装;已在得克萨斯州上线,其他法规正在审查中[9] | 否 | 否 |
| 电信查询 | 适用于用户在提供该服务的运营商处拥有线路的情况 | 同上 | 同上 | 同上 | 同上 |
| 钱包或 eID | 适用于存在该方案的地区 | 同上 | 同上 | 同上 | 同上 |
| 自拍估算 | 是 | 是 | 是 | 是 | 需要摄像头 |
| 证件核验 | 是 | 是 | 是 | 是 | 需要摄像头 |
厂商页面查阅于 2026 年 11 月 22 日。最后四行基于我们的解读:这些调用与应用商店无关,因此限制取决于谁持有该凭证或您是否可以采集图像。
时间线
Play Age Signals v0.0.6 现已在全球推出,据 Google 称,最迟于 2026 年 12 月 11 日开始向所有用户返回响应。[1] 相关调用和状态值见 Play Age Signals 集成指南。
网页端的空白
在我们查阅的 Google 或 Apple 页面中,均未提供让网站请求访客年龄范围的方法。[1][5] Google 将使用范围限制为由 Google Play 更新的应用,并且“API 返回的信息只能由发出请求的应用使用”。[1]
巴西的法令仍然要求网页端采取行动。在其关于含有对未成年人不宜或禁止其接触的内容的服务的条款中,可通过浏览器访问的提供商必须评估年龄,并可以使用来自操作系统、应用商店或其他数字服务的信号(Decreto 12.880, art. 26 §2)。[13] 更多内容见巴西的 ECA Digital 和 Google Play。
- React、Vue、Angular、Next.js、Nuxt、Svelte 或原生 JS:使用 Didit Web SDK,支持弹窗或内联方式。[25] 参见使用 JS SDK 进行年龄估算。
- 任何页面:重定向至托管会话 URL 并返回至您的回调。
- 带 Web 外壳的应用:使用原生 SDK,或在不存在原生 SDK 时使用 WebView。[26] 参见 WebView 中的年龄估算。
侧载应用和其他商店
同一个 Android 构建包可能通过四种途径安装,而响应的商店 API 每次都不同。请根据安装来源进行分支处理,而不是根据手机品牌。
| 构建包来源 | 调用的 API | 未响应时 |
|---|---|---|
| Google Play | Play Age Signals | 状态或错误值;对于 APP_NOT_OWNED 和 DEVICE_NOT_SUPPORTED 不可重试[3] |
| Amazon Appstore | 通过内容提供程序调用 GetUserAgeData | responseStatus 为 APP_NOT_OWNED 或 FEATURE_NOT_SUPPORTED,或 userStatus 为 UNKNOWN[8] |
| Galaxy Store | getAgeSignalResult,Galaxy Store 4.6.03.1 或更高版本 | UNKNOWN,包括 Galaxy Store 不是安装源的情况[9] |
| 您的网站、企业安装包或其他应用商店 | 以上四种 API 均不适用 | 您自行核验,或采用适合相应年龄的默认设置 |
缺失答复既不代表未成年人,也不代表成年人。如何按功能逐一处理,请参阅缺失年龄信号时的应对方案。
iOS 与 Android 综合考量
这两种信号在格式、时效性以及拒绝请求的表现形式上均有不同;相关细节请参阅逐字段对比。[2][6] 对于单一代码库,适用以下三条规则。
- 将拒绝请求、空边界和错误视为三种不同的情况。
- 定期重新询问。在原始声明满一年之前,Apple 会持续返回先前的年龄区间。[6]
- 在加利福尼亚州需先查阅法律:自 2027 年起,法律未作要求的请求将被禁止,但为维持合规而进行的定期请求不受此限。[12]
在 Mac 上,Apple 的资格属性会返回 false,但仍可调用 requestAgeRange 获取声明的年龄区间。[6] 在我们查阅的文档中,未发现适用于 Windows 或 Linux 应用的对等信号。
同一用户,两个终端:保留哪个年龄
用户在您的 Android 应用中共享了年龄区间,随后又在您的网站上登录。两项规定存在冲突。
加利福尼亚州,自 2027 年 1 月 1 日起
知情状态随用户转移
- 接收到信号的开发者,即被视为在应用的所有平台上均实际知晓该年龄区间,包括用户创建或登录账户的网站[12]
- 该信号为主要依据,除非开发者内部掌握不一致的明确且有说服力的信息[12]
Civil Code 1798.501(d),经 AB 1856 修订
Google,当前规定
数据仅保留在应用内
- API 返回的信息仅可由发起请求的应用使用[1]
- 除法律严格要求外,不得出于任何原因将其出售、共享或转让给任何第三方[4]
Play Age Signals 条款和用户数据政策
未解决
截至 2026 年 11 月 22 日,我们未发现 Google 或加利福尼亚州协调两者的任何页面。在将信号复制到共享用户个人资料之前,请咨询法律顾问。加利福尼亚州信号中的年龄为声明年龄,且该法案禁止提示用户更改该年龄。[12]
Apple 的许可将年龄范围的使用限制在您应用中适合年龄的内容或功能,或限制在要求您接收该范围的法律范围内。[7] 您自己核验得出的结果是一条不同的记录。您是根据自己的告知收集该结果的,因此 Google 和 Apple 的信号条款对其不适用。它是否可用于所有场景取决于您的告知和法律依据:请向法律顾问确认。请将两者分开存储,且不要将任何一家应用商店的信号发送给年龄核验供应商。
当您的结果与信号不一致时,适用规则取决于具体法域。在阿拉巴马州(自 2027 年 1 月 1 日生效,已在法院受到质疑,截至 2026 年 11 月 22 日未发现裁决)、犹他州(自 2027 年 5 月 6 日起)和巴西,对于这些法律文本涵盖的默认设置和限制,以较低或保护力度更大的年龄为准,因此您自己的核验只能更严格。[13][14][15][28] 加利福尼亚州没有任何文本表明年龄估计属于明确且有说服力的信息。各州的具体规则见应用商店问责法案指南和加利福尼亚州针对应用程序的四项规则。
自拍和证件 API:它们返回的内容
您可以在任何配备摄像头的界面上自行运行这两项功能。它们返回的数据量大不相同。
| 字段 | 自拍年龄估算 | 证件核验 |
|---|---|---|
| 年龄 | age_estimation,以小数表示的年数,无法估计人脸年龄时为 null[16] | date_of_birth 和 age[19] |
| 判定 | status:Approved 或 Declined | status:Approved、Declined 或 In Review |
| 真人 | 静默活体 score,0 到 100,始终在同一调用中返回 | 证件活体检测会筛查图像;与自拍的人脸比对是一个独立步骤 |
| 身份信息 | 无 | 姓名、证件号码、签发州或国家、证件上印制的地址 |
| 警告 | AGE_BELOW_MINIMUM、AGE_NOT_DETECTED、LOW_LIVENESS_SCORE、LIVENESS_FACE_ATTACK、NO_FACE_DETECTED | 过期、屏幕截图、打印复印件等 |
独立端点。[16][19]
自拍得出的结果由模型预测,Didit 自己的文档指出将其“用于年龄门控和低摩擦核验,不作为法定年龄证明”。[16] 在 Didit 包含 2,399 张 13 岁及以上人群自拍的锁定评估集中,自 2026 年 11 月 4 日起投入生产环境的模型对于 16 和 17 岁人群的平均绝对误差为 1.1 岁,对于 18 至 20 岁人群的平均绝对误差为 1.9 岁。[17] 这就是为什么 18 岁门控需要一个区间,而不是单一分界线。
仅靠估计尚不足够的情形
在巴西,对于禁止未成年人接触的内容和博彩,仅靠估计尚不足够:ANPD 的初步指南草案要求核验作为估计的补充。[29] 一旦读取所需信息,当地不得保留证件图像。[13]
Didit:POST /v3/age-estimation/ 和托管会话
当您已经自行采集自拍时,请使用独立端点;当您希望由我们代为运行界面时,请使用托管会话。参数详见我们的年龄估算 API文章。
您掌控相机
独立 API
- 传入一张图像,在同一请求中返回一个结果
- 仅支持静默活体检测
- 无证件后备流程:由您自行调用下一步
- 由您展示生物识别告知并获取同意
POST /v3/age-estimation/
Didit 运行界面
托管会话
- Web SDK、原生 SDK、重定向或链接
- 动作或静默活体检测
- 针对您设定的区间执行证件步骤
- 针对伊利诺伊州、得克萨斯州和科罗拉多州的生物识别同意步骤
POST /v3/session/
自拍调用
请从您的服务器调用,确保 API 密钥绝不会暴露给应用程序或浏览器。
curl -X POST 'https://verification.didit.me/v3/age-estimation/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F 'user_image=@./selfie.jpg' \
-F 'age_estimation_decline_threshold=18' \
-F 'face_liveness_score_decline_threshold=30' \
-F 'save_api_request=false'
审核通过的响应示例,已缩略:
{
"request_id": "0c40ba43-64ab-4e2e-b4b8-7d1f12f81bc1",
"age_estimation": {
"status": "Approved",
"method": "PASSIVE",
"score": 97.5,
"age_estimation": 27.33,
"warnings": []
}
}
默认存储人脸数据
当 save_api_request 保持默认值 true 时,调用将保存为会话,人脸裁剪图和参考图像将被存储,人脸特征向量会加入您应用程序的人脸索引,并发送 status.updated webhook。设为 false 时不存储任何内容,且后续无法查询 request_id。[16] 请首先将判定结果保存在您自己的记录中。
- 请读取响应体:未成年或伪造采集仍会返回包含
Declined的 HTTP 200,且任何警告都会导致拒绝。[16] - 如果您应用自己的区间,请设置
age_estimation_decline_threshold=0;活体检测仍会决定最终状态。[16] - 除非有需要,否则请忽略包含预测性别的人脸级
entities列表。 - 绝不要将 401、403 或 429 视为年龄结果。
- 请将 API 参考文档中的
Declined示例复制到测试中:沙盒密钥始终返回年龄为 30 岁的已通过模拟结果。[16]
托管会话
在控制台中创建 Adaptive Age Verification 工作流,然后从您的后端启动会话。
curl -X POST 'https://verification.didit.me/v3/session/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_AGE_WORKFLOW_ID",
"vendor_data": "user-123",
"callback": "https://example.com/age/done",
"metadata": {"surface": "web"}
}'
201 响应携带 session_id、session_token 和 url。[20] 原生 SDK 使用令牌启动,Web SDK 使用 URL 启动:
import { DiditSdk } from '@didit-protocol/sdk-web';
DiditSdk.shared.onComplete = (result) => {
// UI feedback only: the decision arrives on your server
showStatus(result.type); // completed, cancelled or failed
};
DiditSdk.shared.startVerification({ url: sessionUrl });
启用后备机制时,低于 borderline_minimum_age_threshold 的估算值会触发 AGE_BELOW_MINIMUM,处于该区间内的估算值会继续进入证件核验,无法检测到年龄的人脸也是如此。[18] 在决策结果中,请从 liveness_checks[].age_estimation 读取估算值。后备机制指南中介绍了如何选择区间。
在应用和网页端复用相同的 vendor_data。如果用户在当前工作流版本中留下了未完成的会话,系统将返回同一会话,而不会创建新会话。已完成的会话绝不会被复用,因此请将结果保存在您的账户记录中。[20] 绝不要将 Google 或 Apple 信号放入 metadata。
信任 webhook 之前先进行验证
检查签名和时间戳
检查 X-Signature-V2,这是使用您的目标密钥对规范 JSON 计算的 HMAC-SHA256:键按字典序排序、紧凑分隔符、Unicode 不转义、整数值的浮点数以整数形式书写。它覆盖整个有效载荷,官方文档提供了适用于 Node.js、Python 和 PHP 的现成代码。[21]
- 拒绝与当前时间相差超过 300 秒的时间戳,并进行恒定时间比较。[21]
- 同时接受
-Previous请求头:在您轮换密钥后的 24 小时内会发送该请求头。[21] - 以
event_id为键,不要让较旧的事件覆盖较新的状态:事件到达顺序无法保证。[21] - 避免使用
X-Signature-Simple:它已被弃用,且不覆盖决策结果。[21]
成本与数据
我们查阅的 Google 和 Apple 年龄页面表明其年龄范围 API 不收取费用。[1][5] 您运行的核验按次收取挂牌价(定价)。
| Didit 路径 | 挂牌价 | 计费触发条件 |
|---|---|---|
| Age Estimation,独立使用 | $0.10 | 每次 HTTP 200 响应,包括被拒绝的响应[16][22] |
| 工作流中的 Age Estimation 步骤 | $0.10 | 该步骤,包含活体检测[17][22] |
| 针对该区间的证件步骤 | 额外增加 $0.15[22] | 仅对进入该步骤的用户计费;证件与自拍之间的人脸比对不会作为单独的 Face Match 计费[17] |
托管式年龄门控的费用为每位核验用户 $0.10,再加上落入您设定区间的用户比例对应的 $0.15。先索取应用商店信号可以减少需要核验的用户数量。
数据是第二项成本。
- 当您只需要年龄决策而不需要其他信息时,请使用 ISO/IEC 27566-1 工作流:响应属性已被锁定,13 岁为最低准入年龄,且不存储生物识别模板。[17]
- 在其他工作流中关闭您不需要的返回数据;未提供的值将返回为
null。[23] - 设置从 1 个月到 10 年的保留期,或在收到 webhook 后删除每个会话。[23]
- 为伊利诺伊州、得克萨斯州和科罗拉多州保留生物识别同意步骤,并在这些地区发布原生 SDK 4.10.0 或更高版本。[24]
- 注意各方角色:Didit 是处理者,您是控制者,默认区域为欧盟(爱尔兰)。[23]
何时停止
如果信号已足够,就此停止。对每位用户进行二次检查很难符合数据最小化原则。
Didit 如何在应用商店信号无法覆盖的场景提供帮助
Didit 通过一个 API 密钥和一个 webhook,在网页端、原生应用以及无应用商店响应的构建版本中运行年龄估算。它从自拍开始,仅在您设定的区间内要求提供证件。它不读取 Google 或 Apple 信号:您的应用自行决定是否需要检查,并在无需这些信号的情况下启动会话。可在 demos.didit.me 或在 Academy 视频中查看。

Didit 控制台中的年龄估算结果(示例数据):自拍得出的估算年龄与证件上的年龄并排显示。
Didit 提供
- 具备活体检测的自拍年龄估算,支持 API 或托管会话
- 针对处于临界估算值的证件核验步骤
- Web 和原生 SDK(iOS、Android、React Native、Flutter)
- 已签名 webhook、返回数据开关以及通过 API 删除
由您负责
- 调用 Google、Apple、Amazon 或 Samsung API 并将数据保存在应用内
- 阈值、区间以及它们所把控的功能
- 法律依据、告知和决策
核心要点
- 商店和系统级别的年龄 API 仅在自身应用内响应。网站和侧载构建版本无法从中获得响应。
- 自拍 API 返回估算年龄;证件 API 则返回出生日期和多得多的数据。
- 使用独立端点时,请设置
save_api_request=false,否则人脸图像将被存储并建立索引。 - 依据已签名的 webhook 采取操作,切勿依赖浏览器报告的结果。
常见问题解答
是否有免费的年龄验证 API?
我们查阅的 Google 和 Apple 页面显示 Play Age Signals 或 Declared Age Range 不收取费用,但它们均仅在其自身应用内响应。您自行执行的核验按次计费:Didit 的年龄估算标价为 $0.10。
是否可以在没有身份证件的情况下验证年龄?
可以,但存在限制:应用商店信号、电信查询、电子钱包凭证或自拍估算。自拍提供的是估算结果,而非具有法律效力的年龄证明,因此证件对于临界年龄和受监管产品仍然有用。
Play Age Signals 是否适用于网页端?
尚未记载任何网页端调用。Google 将使用范围限制为通过 Google Play 更新的应用,并说明返回的信息只能由发起请求的应用使用。
侧载应用如何处理?
如果应用并非由 Play 安装,Play 会返回 APP_NOT_OWNED。Amazon 和 Samsung 仅对来自其自身应用商店的安装作出响应。在其他情况下,请使用适龄默认设置或您自己的核验手段。
如何在 React 网页应用中验证年龄?
在您的后端创建一个会话,安装 @didit-protocol/sdk-web 并使用该会话 URL 调用 startVerification。仅在收到已签名的 webhook 后开放该功能。
年龄估算 API 会返回什么?
Didit 的 API 会返回以岁为单位的估算年龄、静默活体检测评分、Approved 或 Declined 状态以及警告列表。
单次核验能否同时适用于应用端和网页端?
如果您的告知书和法律依据同时涵盖两者,您自己的核验可以:将结果存储在账户中。Google 的信号仅限于发起请求的应用,因此在没有法律意见的情况下,请勿将其复制到网站。
结果如何确保安全?
Webhook 使用 HMAC-SHA256 进行签名。使用恒定时间比较检查 X-Signature-V2,拒绝与当前时间偏差超过 300 秒的时间戳,并对每个 event_id 仅处理一次。
数据保留多长时间?
由您选择。将保留期设置为 1 个月至 10 年,或通过 API 删除会话。在独立调用中,save_api_request=false 将不存储任何内容;默认设置会存储图像和人脸特征向量。
费用是多少?
按挂牌价,每次年龄估算为 $0.10;当用户进入工作流中的证件步骤时,额外收取 $0.15。
来源
- Play Age Signals API overview and terms of service,Android Developers,更新于 2026 年 11 月 18 日。
- Understand age signals responses,Android Developers,查阅于 2026 年 11 月 22 日。
- Handle Play Age Signals API errors,Android Developers,查阅于 2026 年 11 月 22 日。
- Age Signals API and User Data policy,Google Play Console Help,查阅于 2026 年 11 月 22 日。
- Declared Age Range,Apple Developer Documentation,查阅于 2026 年 11 月 22 日。
- Requesting people's age range information in your app,Apple Developer Documentation,查阅于 2026 年 11 月 22 日。
- Apple Developer Program License Agreement, Declared Age Range API terms,Apple,查阅于 2026 年 11 月 22 日。
- User age verification, GetUserAgeData API,Amazon Appstore,更新于 2026 年 9 月 25 日。
- Get Age Signals,Samsung Galaxy Store,查阅于 2026 年 11 月 22 日。
- Know Your Customer Age Verification,CAMARA,The Linux Foundation,查阅于 2026 年 11 月 22 日。
- The EU approach to age verification,European Commission,查阅于 2026 年 11 月 22 日。
- AB 1856, Chapter 184, Statutes of 2026 (amending the Digital Age Assurance Act),加利福尼亚州立法信息。
- 2026 年 3 月 18 日的 Decreto 12.880,第 24 至 26 条,巴西总统府。
- HB 161(Act 2026-59),已通过法案,阿拉巴马州立法机构。
- 犹他州法典 13-76-202,犹他州立法机构。
- Age Estimation API 参考,Didit 文档,访问于 2026 年 11 月 22 日。
- Age Estimation 概述:准确度、后备机制、ISO/IEC 27566-1,Didit 文档,访问于 2026 年 11 月 22 日。
- Age Estimation 警告,Didit 文档,访问于 2026 年 11 月 22 日。
- ID Verification API 参考,Didit 文档,访问于 2026 年 11 月 22 日。
- 创建会话,Didit 文档,访问于 2026 年 11 月 22 日。
- Webhooks,Didit 文档,访问于 2026 年 11 月 22 日。
- 定价,Didit 文档,访问于 2026 年 11 月 22 日。
- 数据保留与返回数据,Didit 文档,访问于 2026 年 11 月 22 日。
- 生物识别知情同意,Didit 文档,访问于 2026 年 11 月 22 日。
- Web SDK 概述,Didit 文档,访问于 2026 年 11 月 22 日。
- 原生 SDK 概述,Didit 文档,访问于 2026 年 11 月 22 日。
- 使用 Play Age Signals API:要求,Android 开发者,访问于 2026 年 11 月 22 日。
- 针对阿拉巴马州应用商店法的诉讼,CCIA(原告),2026 年 10 月。
- ECA Digital:年龄核验指南,2026 年 5 月初步版本,ANPD,访问于 2026 年 11 月 22 日。
我们年龄验证解决方案中的每一个年龄门控都遵循同一模式:存在信号时使用信号,不存在信号时由您自行核验。如需体验核验功能本身,请从 Didit 年龄估算开始。