获取视觉验证结果 - TokenLab

H5 验证完成后，通过此 Action 获取对应的 TokenLab 素材组 ID。

接口与认证

POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

发送创建视觉验证会话返回的 BytedToken。如果创建时设置了 ProjectName，此处必须发送相同且区分大小写的值；否则可省略或使用 default。浏览器回调后，结果可能还需要几秒钟才会就绪。重复请求直到返回 Result.GroupId；BytedToken 的有效期为 30 分钟。同一 token 会返回同一个 GroupId。创建 liveness_face 素材时，将返回的 GroupId 作为 group_id。

请求示例

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

响应示例

{
  "ResponseMetadata": {
    "RequestId": "req_def456",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260720123456-real1"
  }
}

失败时，错误码和错误信息分别位于 ResponseMetadata.Error.Code 和 ResponseMetadata.Error.Message。