AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 实人认证 金融级实人认证 开发参考 金融级多因子意愿认证方案 服务端接入 DescribeFaceVerify-获取认证结果

DescribeFaceVerify-获取认证结果

更新时间：
产品详情
我的收藏

本文介绍如何调用DescribeFaceVerify接口查询金融级多因子意愿认证的认证结果。

接口说明

接口名：DescribeFaceVerify

全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）

请求方法：POST和GET

传输协议：HTTPS

接口说明：当您收到回调通知之后，可以在服务端通过该接口获取相应的认证状态和认证资料。

QPS限量：API独享QPS限量，详情请参见服务端接口QPS限量说明。

请求参数

名称

类型

是否必选

描述

示例值

SceneId

Long

是

认证场景ID。该ID在控制台创建认证场景后自动生成。

100000****

CertifyId

String

是

实人认证唯一标识。该值需要调用InitFaceVerify-发起认证请求获取。

91707dc296d469ad38e4c5efa6a0****

返回数据

名称

类型

描述

示例值

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF039795

Code

String

返回码，200 指接口响应成功。

您可以在Code中查看不同 Code 的详细描述。

200

说明

200指接口响应成功。

Message

String

请求信息的响应消息，对 Code（返回码）的简短描述。

success

ResultObject.Passed

String

认证结果，取值：

  • T：通过

  • F：不通过

说明

判断认证结果请以ResultObject.Passed字段为准。

T

ResultObject.SubCode

String

认证结果描述。

您可以在ResultObject.SubCode错误码说明中查看不同状态码的描述和处理建议。

说明

判断认证结果请以 ResultObject.Passed 字段为准。

200

ResultObject.IdentityInfo

String

认证的主体信息，一般的认证场景返回为空。

null

ResultObject.DeviceToken

String

设备Token。

McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOxxxxxxx

ResultObject.DeviceRisk

String

设备风险标签。

ROOT,VPN,HOOK

说明

多个设备风险标签以半角逗号（,）分隔。

您可以通过设备风险标签了解所有标签及其含义。

ResultObject.MaterialInfo

String

人脸认证主体附件信息：

  • 人脸攻击检测结果及攻击分（faceAttackScore）

  • 人脸遮挡检测结果及质量分（faceOcclusion/qualityScore）以及质量相关详细字段

  • 意愿认证信息内容

  • 人脸照片OSS存储位置及链接

    人脸照片资料和认证视频资料的字段返回依赖不同配置项，具体如下：

    • 人脸照片相关字段（ossBucketName、ossObjectName、pictureUrl）的返回仅依赖控制台认证场景中的配置：

      • 控制台认证场景中开启【是否留存认证资料】

      • 控制台已配置并启用OSS授权

    • 认证视频相关字段（verifyVideoUrl、ossVerifyVideoObjectName）的返回需同时满足以下条件：

      • 控制台认证场景中开启【是否留存认证资料】

      • 控制台已配置并启用OSS授权

      • 客户端在 extParams 参数中配置视频返回（ WebSDK 需要在InitFaceVerify 中显式配置返回视频包含字段）

{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-12600*********",
    "ossObjectName": "verify/1260051251634779/03a081bd96328aedf83f635f3********.jpeg",
    "pictureUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f********.jpeg?&security-token=CAISjgJ1q6Ft..."
  },
  "voluntaryCertInfo": {
    "asrTexts": [
      "本人同意办理XXX业务",
      "本人同意办理XXX业务",
      "本人同意办理XXX业务"
    ],
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
    "voiceOssObjectNames": [
      "verify/1234567890/sha8d374f73c461a00e0****_wish_voice_0.wav",
      "verify/1234567890/sha8d374f73c461a00e0****_wish_voice_1.wav",
      "verify/1234567890/sha8d374f73c461a00e0****_wish_voice_2.wav"
    ],
    "voiceUrls": [
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_voice_0.wav?security-token=CAISjgJ1q6...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_voice_1.wav?Expires=1625371365&OSSAccessKeyId=STS.NTEz8oi35qJpxxX7no5gpGd****&Signature=wnHjNu3333ddW3zNMup1r4ovgrw6xJ0****&security-token=CAISjgJ1q6...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_voice_2.wav?security-token=CAISjgJ1q6F..."
    ],
    "screenVideoOssObjectNames": [
      "verify/1234567890/sha8d374f73****_wish_video_0.mov",
      "verify/1234567890/sha8d374f73****_wish_video_1.mov",
      "verify/1234567890/sha8d374f73****_wish_video_2.mov"
    ],
    "screenVideoUrls": [
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_video_0.mov?security-token=CAISjgJ1q6Ft...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_video_1.mov?security-token=CAISjgJ1q6...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_video_2.mov?security-token=CAISjgJ1q6..."
    ]
  }
}

上一篇：InitFaceVerify-发起认证请求下一篇：SDK调用示例