接口说明
接口名：DescribeFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
请求方法：POST和GET。
传输协议：HTTPS。
接口说明：当您收到回调通知之后，可以在服务端通过该接口获取相应的认证状态和认证资料。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
SceneId | Long | 是 | 认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景，请参见添加认证场景。 | 1000000006 |
CertifyId | String | 是 | 实人认证唯一标识。该值需要调用InitFaceVerify-发起认证请求获取。 | 91707dc296d469ad38e4c5efa6a0**** |
返回数据
名称 | 类型 | 描述 | 示例值 |
RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 请求信息的响应消息。 | success |
Code | String | 返回码，200指接口响应成功。详细认证结果判断，请参见返回Code和Message。 | 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 | 认证主体附件信息，主要为图片类材料。 | {
//是否为攻击：攻击为T，非攻击为F。
"faceAttack": "T",
// 是否有脸部遮挡：有脸部遮挡为T，否则为F。
"faceOcclusion": "F",
// 认证的照片信息。
"facialPictureFront": {
// 人脸攻击分。
"faceAttackScore": 0.00008597839769208804，
// 人脸和身份证照片比对分（仅当product code=ID_PLUS时，认证完成返回）。
"idCardVerifyScore": 50.99797734769861,
// 照片存放客户上海区域的OSS里，此为照片的bucket名。
"ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
// 照片存放客户上海区域的OSS里，此为照片的文件名。
"ossObjectName": "verify/1260051251634779/03a081bd96328aedf83f635f39a50c57_0.jpeg",
// 照片https或htttp地址，有效期15分钟，从查询时开始计时。
"pictureUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57_0.jpeg?Expires=1625371140&OSSAccessKeyId=STS.NTX1ngfr6Acg2Pmnn2RYM****&Signature=Hw5BF9WxJs6wI68IxKs41cxCU8****&security-token=CAISjgJ1q6Ft5B2yfSjIr5ftetTTi60X9qGMMHbcim5nXtZhu7GT1Dz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO1h2TGRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAF%2FHZbelNLYWtipAu5X5oG1t22SqIr1p3TMK5FrjDIVeWOppcxeRXtU%2BjR7hGcwd25scGhiraoxTXV3sxw%2F6dhFSswQ37O4j%2B%2FrCPtiGauqn2ZMdMj%2FvYwKb6KmpQqa%2BtR%2F9cxhS6hoIQRq0SUIfyXl5ZUiZbTjW22iwuX%2BPwzVCw%3D%3D",
// 视频存放客户上海区域的OSS里，此为视频的文件名（仅当客户端设置视频参数时返回）。
"ossVerifyVideoObjectName": "verify/1260051251634779/03a081bd96328aedf83f635****_verifyvideo_dcb7.mov",
// 视频https或htttp地址，有效期15分钟，从查询时开始计时（仅当客户端设置视频参数时返回）。
"verifyVideoUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57__verifyvideo_dcb7.mov?Expires=1625371140&OSSAccessKeyId=STS.NTX1ngfr6Acg2Pmnn2RYM****&Signature=Hw5BF9WxJs6wI68IxKs41cxCU8****&security-token=CAISjgJ1q6Ft5B2yfSjIr5ftetTTi60X9qGMMHbcim5nXtZhu7GT1Dz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO1h2TGRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAF%2FHZbelNLYWtipAu5X5oG1t22SqIr1p3TMK5FrjDIVeWOppcxeRXtU%2BjR7hGcwd25scGhiraoxTXV3sxw%2F6dhFSswQ37O4j%2B%2FrCPtiGauqn2ZMdMj%2FvYwKb6KmpQqa%2BtR%2F9cxhS6hoIQRq0SUIfyXl5ZUiZbTjW22iwuX%2BPwzVCw%3D%3D",
// 活体人脸质量分数。
"qualityScore": 99.93476867675781,
// 人脸和公安比对分数，阈值可参考下表详细说明。
"verifyScore": 57.678396649466755
},
// 身份证OCR信息（仅当product code=ID_PLUS时，认证完成返回OCR识别的信息和图片）。
"ocrIdCardInfo": {
// 身份证字段信息。
},
"ocrPictureFront": {
// 身份证OCR照片存放客户上海区域的OSS里，此为身份证OCR照片的Bucket名。
"ossBucketName": "cn-shanghai-aliyun-cloudauth-1234567890",
// 身份证OCR照片存放客户上海区域的OSS里，此为身份证OCR照片人脸面的文件名。
"ossIdFaceObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridface_b749.jpeg",
// 身份证OCR照片人脸面的https或http地址，有效期15分钟，从查询时开始计时。
"ossIdFaceUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridface_b749.jpeg?Expires=1625371165&OSSAccessKeyId=STS.NTGterbRtcVY7ykxixaQ6****&Signature=SqZoqBch%2BsdJefkabdaIJrPJWqtD%2FlmF****&security-token=CAISjdfgeJ1q6Ft5B2yfSjIr5fyP9%2FGj41V1JSyNV%2FanGktbd4aqInAmjz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO30McmRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAGe2a1NFO2XabhICqmUeN%2FLV25GuhaexEjjGL4sDC2VWjasWBmKzlXTQ6mHZoI9IhswopdGLLlWPC5ONnLNASWQEObAM28FAViS76clUdE8YVCMyU%2BuyFqLGeRNx4NjcPa%2FlOa9wsxjg4LwlfHKeXA3g0X%2BQQcRAqFc2j093K2r6A%3D%3D",
// 身份证OCR照片存放客户上海区域的OSS里，此为身份证OCR照片国徽面的文件名。
"ossIdNationalEmblemObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridnationalemblem_a3hf.jpeg",
// 身份证OCR照片国徽面的https或http地址，有效期15分钟，从查询时开始计时。
"ossIdNationalEmblemUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridnationalemblem_a3hf.jpeg?Expires=1625371365&OSSAccessKeyId=STS.NTEz8oi35qJpxxX7no5gpGd****&Signature=wnHjNu3333ddW3zNMup1r4ovgrw6xJ0****&security-token=CAISjgJ1q6Ft5B2yfSjIr5fwMYLbhOwUxoibel7p0246OehcqLL%2BpTz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO34PcmRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAFThVhIcXH8zQiqbYVkTCHpZVRmDHH0mZ%2FMNuGikqSWdK3%2FhaSEvxmO1wyLH9E7mFzoKJErtxTCs453H6PYHO8H3pKOpKgZ0PfWTpJ8OEIJm26fKph%2F%2F3usSUBx5h0Ob17e2XB4BffkOJKQQiU3vXqoOZ6Vlyf7QpEJSvUMXXSKSg%3D%3D"
}
}
|
ResultObject.UserInfo | String | 记录在生僻字模式下用户输入的身份信息与对应编码。返回数据为JSON格式字符串，姓名中无生僻字返回为空字符串。 | { "number":"610***********1110", "name":"王先生", "verifyName":"王先" } |
设备风险标签说明
风险类别 | 风险标签 | 描述 |
设备风险类（Native SDK） | ROOT | 设备疑似ROOT、越狱。 |
HOOK | 设备疑似HOOK。 |
VPN | 设备疑似VPN。 |
Emulator | 设备疑似模拟器。 |
SystemVirtual | 设备系统多开。 |
ThirdVirtual | 设备三方多开。 |
AdbModel | 设备开启开发者模式。 |
NoSimCard | 设备未插卡。 |
VirtualVideo | 虚拟视频注入。 |
MirroredScreen | 屏幕录屏截屏。 |
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错误码说明。
verifyScore阈值说明
千分之一误识率 | 万分之五误识率 | 万分之一误识率 | 十万分之五误识率 | 十万分之一误识率 | 百万分之一误识率 |
70 | 71.5 | 75 | 76.5 | 80 | 85 |
说明 如果您有个性化需求，您可以根据业务情况，参考返回的比对分和阈值，自定义认证结果。
返回Code和Message说明
具体说明，请参见返回Code和Message。