本文介绍了如何通过DescribeFaceVerify接口在服务端接入流程中查询活体检测的结果。
接入方式说明
如果采用服务端接入方式，您可以配合SDK调用InitFaceVerify接口发起认证请求，获取CertifyId，唤起客户端上传人脸信息。用户上传人脸信息后，您可以调用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和Message中查看不同 Code 的详细描述。 | 200 |
Message | String | 请求信息的响应消息，对 Code（返回码）的简短描述。 | success |
ResultObject.Passed | String | 认证结果，取值：
说明 判断认证结果请以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 | 人脸认证主体附件信息，包含人脸质量、人脸攻击、人脸或OCR图片以及意愿认证等数据信息。 |