如何查询App实人认证方案的认证结果_实人认证(ID Verification)-阿里云帮助中心

本文介绍如何通过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和Message中查看不同 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	人脸认证主体附件信息，包含人脸质量、人脸攻击、人脸或OCR图片以及意愿认证等数据信息。	MaterialInfo
ResultObject.UserInfo	String	记录在生僻字模式下用户输入的身份信息与对应编码。返回数据为JSON格式字符串，姓名中无生僻字返回为空字符串。 name：指用户输入的姓名。 verifyName：指通过验证的最终姓名编码。例如生僻字是通过转码认证通过：“王先生”，实际认证通过是“王先升”。 number：指用户输入的证件号码。	`{ "number": "610***********1110", "name": "王先生", "verifyName": "王先" }`