本文介绍了如何通过DescribeFaceVerify接口查询活体人脸验证的结果。

查询认证结果

接口名:DescribeFaceVerify

服务地址:cloudauth.aliyuncs.com。

请求方法:HTTPS POST和GET。

接口说明:当您的终端用户收到回调通知之后,您在服务端通过该接口获取相应的认证状态和认证资料。

请求参数
名称 类型 是否必选 描述 示例值
SceneId Long 认证场景ID。 100000****
CertifyId String 实人认证唯一标识。 91707dc296d469ad38e4c5efa6a0****
返回数据
名称 类型 描述 示例值
RequestId String 请求ID。 130A2C10-B9EE-4D84-88E3-5384FF0****
Message String 请求消息的响应信息。 success
Code String 返回码。关于返回码的详细内容,请参见SubCode错误码说明 200
ResultObject JSON 认证结果。该认证结果是一个JSON结构体,关于具体结构描述,请参见ResultObject
表 1. ResultObject
名称 类型 描述 示例值
Passed String 认证结果。取值:
  • T:通过。
  • F:不通过。
说明 判断认证结果请以Passed字段为准。
T
SubCode String 认证结果描述。更多信息,请参见SubCode错误码说明
说明 判断认证结果请以Passed字段为准。
200
IdentityInfo String 认证的主体信息,一般的认证场景返回为空。 null
DeviceToken String 设备Token。 McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOABBF****
MaterialInfo String 认证主体附件信息,主要为图片类材料。JSON格式,更多信息,请参见返回示例 {"faceAttack": "F","faceOcclusion": "F","facialPictureFront": {"faceAttackScore": 0.00008597839769208804,"qualityScore": 88.3615493774414,"verifyScore": 50.28594166529785,"pictureUrl": "https://cn-shanghai-aliyun-cloudauth-****.oss-cn-shanghai.aliyuncs.com/verify/****.jpeg","ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779","ossObjectName": "verify/1260051251634779/6ba7bcfccf33f56cdb44ed086f36c****.jpeg"}}

返回示例

ResultObject.MaterialInfo的JSON格式示例:
{
     // 是否为攻击:攻击为T,非攻击为F。
    "faceAttack": "F",   
    // 是否有脸部遮挡:有脸部遮挡为T,否则为F。 
    "faceOcclusion": "F",    
    // 认证的照片信息。
    "facialPictureFront": {
        // 人脸攻击分。
        "faceAttackScore": 0.00008597839769208804,
        // 活体人脸质量分数。
        "qualityScore": 88.3615493774414,
        // 人脸比对分数。
        "verifyScore": 50.28594166529785,
        // 照片https地址,有效期15分钟,从查询时开始计时。  
        "pictureUrl": "https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg",
        // 照片存放客户上海区域的OSS里,此为照片的bucket名。
        "ossBucketName": "cn-shanghai-aliyun-cloudauth-126005125163****",
        // 照片存放客户上海区域的OSS里,此为照片的文件名。
        "ossObjectName": "verify/1260051251634779/6ba7bcfccf33f56cdb44ed086f36****.jpeg",
        // 视频存放客户上海区域的OSS里,此为视频的文件名(仅当客户端设置视频参数时返回)。
        "ossVerifyVideoObjectName": "verify/1260051251634779/03a081bd96328aedf83f635****_verifyvideo_dcb7.mov",
        // 视频HTTPS地址,有效期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"  
   }
}
SubCode错误码说明
错误码 认证描述文案 是否计费 可能原因和运营建议
200 认证通过 无。
204 人脸比对不一致 可能不是同一人或活体照片质量较低。建议根据业务情况分层处理,若为同一人可重新操作。
205 活体检测存在风险 可能存在攻击风险。建议人工审核分层处理,若为真人可重新操作。
206 业务策略限制 个性化业务安全策略限制,如有疑问可咨询客服。