liveness_face 素材前,先创建真人视觉验证会话。TokenLab 使用火山引擎 Action API 的请求格式,并使用 TokenLab Bearer 认证。
接口与认证
CallbackURL 为必填项,且必须是公开的 HTTPS URL。ProjectName 可选,默认值为 default。
流程
- 保存
Result.BytedToken,并为待验证人员打开Result.H5Link。 - 如需指定 H5 语言,请在
H5Link后追加lng,例如&lng=en。语言不是请求体字段。 - H5 流程完成后,浏览器会打开
Result.CallbackURL。回调查询参数可能包含bytedToken、resultCode、algorithmBaseRespCode、reqMeasureInfoValue和verify_type。 - 使用保存的
BytedToken轮询 获取视觉验证结果,直到返回Result.GroupId。
BytedToken 的有效期为 30 分钟,并与已认证的组织和 ProjectName 绑定。H5 链接仅支持完成一次认证,使用后即失效。
请将 Result.H5Link 视为不透明的浏览器 URL:以顶层页面打开,不要解析、解码、改写或嵌入。浏览器交接和回调桥接由 TokenLab 负责。
请求示例
响应示例
ResponseMetadata.Error.Code 和 ResponseMetadata.Error.Message,不要按 TokenLab 其他 /v1 API 的错误字段处理。