本文介绍了如何通过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 |
Message | String | 错误信息。 | success |
Code | String | 返回码。具体说明,请参见返回Code和Message。 | 200 说明 200表示接口响应成功。 |
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 | 认证主体附件信息,主要为图片类材料。 |
|
设备风险标签说明
风险类别 | 风险标签 | 描述 |
设备风险类(Native SDK) | ROOT | 设备疑似ROOT、越狱。 |
HOOK | 设备疑似HOOK。 | |
VPN | 设备疑似VPN。 | |
Emulator | 设备疑似模拟器。 | |
SystemVirtual | 设备系统多开。 | |
ThirdVirtual | 设备三方多开。 | |
AdbModel | 设备开启开发者模式。 | |
NoSimCard | 设备未插卡。 | |
VirtualVideo | 虚拟视频注入。 | |
MirroredScreen | 屏幕录屏截屏。 说明 仅支持iOS。 | |
RiskROM | 高危定制ROM。 说明 仅支持安卓。 | |
AutoOperation | 自动化操作。 | |
BlackTool | 安装高危工具。 | |
CloudPhone | 云手机。 | |
ChargeScreenBright | 手机充电屏幕长亮。 说明 仅支持安卓。 | |
ChargeScreenNoSecure | 手机充电无锁屏密码。 说明 仅支持安卓。 | |
设备风险类(Web SDK) | VirtualBrowser | 疑似虚拟浏览器。 |
AutoOperation | 疑似自动化工具。 | |
BrowserTampered | 疑似浏览器参数被篡改。 | |
Debugger | 疑似页面JS被调试。 | |
CookieDisabled | cookie被禁用。 | |
Incognito | 浏览器处于隐身模式。 | |
deviceToken风险类 | TokenIsNull | deviceToken为空。 |
TokenTampered | deviceToken篡改。 | |
TokenInvalid | deviceToken无效。 | |
TokenExpired | deviceToken过期(7天有效)。 | |
其他 | NoRisk | 设备风险较低。 当系统未检测出上述风险时返回NoRisk标签。 |
NoTag | 无tag命中。 当因为实人认证系统异常无法获取风险标签时,系统自动返回NoTag标签。 |
ResultObject.SubCode错误码说明
具体说明,请参见ResultObject.SubCode错误码说明。
返回Code和Message说明
具体说明,请参见返回Code和Message。