本文介绍如何通过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 | 认证结果,取值:
说明 判断认证结果请以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图片以及意愿认证等数据信息。 | |
ResultObject.UserInfo | String | 记录在生僻字模式下用户输入的身份信息与对应编码。返回数据为JSON格式字符串,姓名中无生僻字返回为空字符串。
|
|