真人素材认证流程

真人认证包含两个服务端 Action 和一次终端用户 H5 操作。最终应以服务端查询结果为准。

1. 创建认证会话

调用 CreateVisualValidateSession，传入公网可访问的 CallbackURL。

回调地址长度不能超过 2048，不应包含用户敏感信息，也不能指向 localhost、私网或链路本地地址。响应包含：

• BytedToken：本次认证的唯一凭证，有效期 30 分钟且仅可认证一次。
• H5Link：交给终端用户打开的认证页面，使用后失效。
• CallbackURL：认证完成后的跳转地址。

2. 打开 H5Link

将 H5Link 交给终端用户，并保存 BytedToken。需要指定页面语言时，可在 H5Link 后使用 lng 参数；支持 zh、en 和 zh-Hant。

3. 处理回调

用户完成操作后，浏览器会跳转到 CallbackURL，并附加以下查询参数：

回调表示终端流程已经结束，但不能替代服务端查询。

4. 获取真人素材组

当 resultCode 为 10000 时，调用 GetVisualValidateResult，传入保存的 BytedToken。

成功响应中的 GroupId 是本次认证创建的 LivenessFace 素材组 ID。认证尚未完成时，服务可能返回待处理错误；不要重复使用已经消费或过期的 BytedToken。