本文介绍了如何通过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-5384FF0**** |
Code | String | 返回码，200 指接口响应成功。 您可以在返回Code和Message中查看不同 Code 的详细描述。 | 200 |
Message | String | 请求信息的响应消息，对 Code（返回码）的简短描述。 | success |
ResultObject | JSON | 认证结果。该认证结果是一个JSON结构体，关于具体结构描述，请参见ResultObject。 |
表 1. ResultObject
名称 | 类型 | 描述 | 示例值 |
Passed | String | 认证结果。取值：
| T |
SubCode | String | 认证结果描述。 您可以在ResultObject.SubCode错误码说明中查看不同状态码的描述和处理建议。 说明 判断认证结果请以 ResultObject.Passed 字段为准。 | 200 |
IdentityInfo | String | 认证的主体信息，一般的认证场景返回为空。 | null |
DeviceToken | String | 设备Token。 | McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOABBF**** |
ResultObject.DeviceRisk | String | 设备风险标签。 | ROOT,VPN,HOOK 说明 多个设备风险标签以半角逗号（,）分隔。 您可以通过设备风险标签了解所有标签及其含义。 |
MaterialInfo | String | 人脸认证主体附件信息，包含人脸质量、人脸攻击、人脸或OCR图片以及意愿认证等数据信息。 |