跳到主要内容

3 篇博文 含有标签「age-verification」

查看所有标签

年龄验证 API 响应中的短 URL 字段

年龄验证创建响应(来自 POST /age-verification/perform-access-age-verification 及其他 perform-* 年龄验证端点)现在除 idurl 外,还会返回 shortUrl

新功能

  • 短链接shortUrl 是较短链接,会重定向到与完整 url 相同的验证体验。当查询字符串过长不便使用时(例如生成二维码,或用户在另一台设备上完成验证),可使用它。
  • 完整 URL 不变:会话 JWT 仍位于完整 urltoken 查询参数中。请勿自行缩短或重新构造该 URL。
  • 不透明值:将 shortUrl 视为不透明字符串,按返回原样展示或编码;不要依赖固定的路径或查询结构,其形式日后可能会变。

了解更多

浏览器和设备兼容性

我们已在文档中新增 浏览器和设备兼容性 页面,方便您快速查看我们年龄验证流程支持的浏览器和设备。

新功能

浏览器和设备兼容性

新页面列出桌面端和移动端的最低浏览器版本,以及嵌入式浏览器(iOS 的 ASWebAuthenticationSession、Android 的 Chrome Custom Tabs)的要求。它将我们各验证提供商的兼容性要求整合为单一参考。

新文档

验证 URL 有效期与 get-status 文档

我们更新了年龄验证文档,补充了 URL 有效期、过期 URL 处理及状态查询说明。

新功能

  • URL 有效期:验证 URL 自创建起 2 周内有效。过期时间位于 JWT 的 token 查询参数中,可使用标准 exp 声明判断 URL 是否仍有效。
  • 过期 URL:使用保存的验证 ID 调用 /age-verification/get-status。若未找到该验证,请创建新的验证。
  • 不依赖 URL 查询状态:使用验证 ID 调用 get-status 可随时查询状态(例如 URL 过期后或未收到 webhook 时)。
  • 保留期限:超过 2 周仍为 PENDING 的验证会被删除,get-status 将不再返回。

更新的文档