AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 实人认证 金融级实人认证 开发参考 金融级实人认证方案 App（SDK）接入方案 服务端集成 DescribeFaceVerify-获取认证结果

DescribeFaceVerify-获取认证结果

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

本文介绍如何通过DescribeFaceVerify接口查询App实人认证方案的认证结果。

接口说明

接口名：DescribeFaceVerify

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

请求方法：POST和GET

传输协议：HTTPS

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

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

请求参数

名称

类型

是否必选

描述

示例值

SceneId

Long

是

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

1000000006

CertifyId

String

是

实人认证唯一标识。

该值需要调用InitFaceVerify-发起认证请求获取。

91707dc296d469ad38e4c5efa6a0****

返回数据

名称

类型

描述

示例值

RequestId

String

请求ID。

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

Code

String

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

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

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

ID_PRO与ID_PLUS包含不同的返回，点击不同Tab查看对应结果。也可以从人脸认证主体附件信息中查看详情。

ID_PRO

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

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

  • 人脸照片和权威源比对分（verifyScore）

    说明

    verifyScore为活体人脸照片和权威源照片比对分。

  • 人脸照片OSS存储位置及链接（视频可选）

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

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

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

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

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

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

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

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

ID_PLUS

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

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

  • 人脸照片和权威源比对分（verifyScore）

    说明

    verifyScore为活体人脸照片和权威源照片比对分。

  • 人脸照片和OCR身份证照片比对分（idCardVerifyScore）

    说明

    idCardVerifyScore为活体人脸照片和身份证照片比对分。

  • OCR识别的信息及照片OSS存储位置及链接

  • 人脸照片OSS存储位置及链接（视频可选）

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

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

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

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

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

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

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

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

ID_PRO

{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "verifyScore": 57.678396649466755,
    "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...",
    "ossVerifyVideoObjectName": "verify/1260051251634779/03a081bd96328aedf83f635****_verifyvideo_dcb7.mov",
    "verifyVideoUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57__********.mov?security-token=CAISjgJ1q6Ft..."
  }
}

ID_PLUS

{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "verifyScore": 57.678396649466755,
    "idCardVerifyScore": 50.99797734769861,
    "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...",
    "ossVerifyVideoObjectName": "verify/1260051251634779/03a081bd96328aedf83f635****_verifyvideo_dcb7.mov",
    "verifyVideoUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57__********.mov?security-token=CAISjgJ1q6Ft..."
  },
  "ocrIdCardInfo": {
    "address": "XXX省XX市XXX区XX街道X号",
    "authority": "XXX公安局XXX分局",
    "birth": "20010213",
    "certName": "张先生",
    "certNo": "4****************X",
    "endDate": "20450523",
    "nationality": "汉",
    "sex": "男",
    "startDate": "20250523"
  },
  "ocrPictureFront": {
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-12********",
    "ossIdFaceObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c********cd_ocridface_b749.jpeg",
    "ossIdFaceUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridface_b749.jpeg?security-token=CAISjdfgeJ1q6F...",
    "ossIdNationalEmblemObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c********cd_ocridnationalemblem_a3hf.jpeg",
    "ossIdNationalEmblemUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridnationalemblem_a3hf.jpeg?security-token=CAISjgJ1q6..."
  }
}

ResultObject.UserInfo

String

记录在生僻字模式下用户输入的身份信息与对应编码。返回数据为JSON格式字符串，姓名中无生僻字返回为空字符串。

  • name：指用户输入的姓名。

  • verifyName：指通过验证的最终姓名编码。例如生僻字是通过转码认证通过：“王先生”，实际认证通过是“王先升”。

  • number：指用户输入的证件号码。

{
  "number": "610***********1110",
  "name": "王先生",
  "verifyName": "王先"
}

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