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 的錯誤欄位。