调用DescribeSmartVerify查询增强版实人认证的结果。

接口名:DescribeSmartVerify

服务地址:cloudauth.aliyuncs.com

请求方法:POST和GET。

传输协议:HTTPS。

接口说明:当接入方的移动端收到回调之后,其服务端可以调用此接口,获取相应的认证状态和认证资料。

请求参数

名称 类型 是否必选 示例值 描述
SceneId Long 100000**** 认证场景ID。

您必须先在增强版实人认证控制台创建认证场景,才能获得认证场景ID。更多信息,请参见添加认证场景

CertifyId String 91707dc296d469ad38e4c5efa6a0**** 认证请求ID。

您必须先调用InitSmartVerify提交认证请求,才能获得认证请求ID。

返回数据

名称 类型 是否必选 示例值 描述
RequestId String 130A2C10-B9EE-4D84-88E3-5384FF039795 请求ID。
Message String success 错误信息。
Code String 200 返回码,200表示接口响应成功。
ResultObject.Passed String T 认证是否通过,取值:
  • T:通过。
  • F:不通过。
说明 如果接口异常或接口是未认证状态,则不返回该参数。
ResultObject.PassedScore String 80.2 综合决策分数,取值:0~100。

阈值为80分,大于或等于80分表示认证通过,低于80分表示认证不通过。

ResultObject.SubCode String 200 认证结果码,请参见ResultObject.SubCode补充说明
ResultObject.MaterialInfo.ocrIdCardInfo String {"ocrIdCardInfo": {身份证字段信息} } 认证主体附件信息中的证件OCR信息。
ResultObject.MaterialInfo.ocrPictureInfo String {"ocrPictureInfo":{"ossBucketName":"cn-shanghai-aliyun-cloudauth-1260051251634779","ossIdFaceObjectName":"smart/126005125*****/efcda7614d1f0a5f41dbc914xxxx_ocridface_6756.jpeg","ossIdNationalEmblemObjectName":"smart/126005125xxxx/efcda7614d1f0a5f41dbc9xxxxx_ocridnationalemblem_5277.jpeg","ossIdFaceUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg","ossIdNationalEmblemUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg"}} 认证主体附件信息中的证件照片。
说明 返回的链接在15分钟内有效。
ResultObject.MaterialInfo.riskInfo String {"riskInfo": { "score": 35,"tags": "rm0114"} } 认证主体附件信息中的业务安全类信息,请参见ResultObject.MaterialInfo.riskInfo补充说明
ResultObject.MaterialInfo.deviceInfo String {"deviceInfo": {"tags": "is_rooted","umid": "f98580e024684ea3e2acbe7aa7e1****"}} 认证主体附件信息中的设备安全类信息,请参见ResultObject.MaterialInfo.deviceInfo补充说明
ResultObject.MaterialInfo.facePictureInfo String {"facePictureInfo":{"ossBucketName":"cn-shanghai-aliyun-cloudauth-126005125xxxx","ossFaceObjectName":"smart/126005125xxxx/adc6048e5355deecabff8374b6xxxx_face_ed03.jpeg","pictureUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg"}} 认证主体附件信息中的人脸照片。
说明 返回的链接在15分钟内有效。
ResultObject.MaterialInfo.verifyInfo String {"verifyInfo": { "authorityComparisionScore": 26,"idCardFaceComparisonScore": 26} } 认证主体附件信息中的认证信息。结构如下:
  • authorityComparisionScore:String类型,表示认证过程中所提交的人脸照片和权威数据的比对分。取值范围:0~100
    置信度阈值参考:
    • 误识率0.001%时,对应阈值95。
    • 误识率0.01%时,对应阈值90。
    • 误识率为0.1%时,对应阈值80。
    • 误识率为1%时,对应阈值为60。
  • idCardFaceComparisonScore:String类型,表示认证过程中所提交的人脸照片和身份证人像面图片上人脸的比对分。取值范围:0~100
    置信度阈值参考:
    • 误识率0.001%时,对应阈值95。
    • 误识率0.01%时,对应阈值90。
    • 误识率为0.1%时,对应阈值80。
    • 误识率为1%时,对应阈值为60。
ResultObject.MaterialInfo的JSON格式示例:
{
    // 身份证信息,在Ocr=T时才返回该字段。
    "ocrIdCardInfo": {
        // 身份证字段信息。
    },
    // 身份证照片OSS存储信息,在Ocr=T时才返回此字段。
    "ocrPictureInfo": {
        // 身份证OCR照片Bucket名称。
        "ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
        // 身份证OCR照片人脸面的文件名称。
        "ossIdFaceObjectName": "smart/126005125xxxxx/efcda7614d1f0a5f41dbc914xxxx_ocridface_6756.jpeg",
        // 身份证OCR照片国徽面的文件名称。
        "ossIdNationalEmblemObjectName": "smart/126005125xxxx/efcda7614d1f0a5f41dbc9xxxxx_ocridnationalemblem_5277.jpeg",
        // 身份证正面照片URL。
        "ossIdFaceUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg",
        // 身份证国徽页照片URL。
        "ossIdNationalEmblemUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg"
    },
    // 业务安全类信息。
    "riskInfo": {
         // 分数。
         "score": 35,
         // 标签。
         "tags": "rm0114"
    },
    // 设备安全信息。
    "deviceInfo": {
   // 设备安全标签。
    "tags": "is_rooted",
  // 设备唯一ID。        
    "umid": "f98580e024684ea3e2acbe7aa7e116aa"
    },
    // 人脸照片OSS存储信息。
    "facePictureInfo": {
        // 人脸照片Bucket名称。
        "ossBucketName": "cn-shanghai-aliyun-cloudauth-126005125xxxx",
        // 人脸照片文件名称。
        "ossFaceObjectName": "smart/126005125xxxx/adc6048e5355deecabff8374b6xxxx_face_ed03.jpeg",
        // 人脸照片Url。
        "pictureUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg"
},
    // 认证结果信息。
    "verifyInfo": {
        // 认证过程中所提交的人脸照片和权威数据的比对分。
        "authorityComparisionScore": 26,
        // 认证过程中所提交的人脸照片和身份证人像面图片上人脸的比对分。
        "idCardFaceComparisonScore": 26
    }
}
ResultObject.SubCode补充说明
错误码 认证描述文案 是否计费 说明
200 认证通过。 认证通过。
201 实名校验不通过。 认证不通过,可能原因:用户的身份信息不匹配、信息有误或查询不到身份信息。
202 查询不到身份信息。 认证不通过,可能原因:用户户口迁移、军人等特殊状态导致,建议预留人工审核入口,用于人工审核。
203 查询不到照片或照片不可用。 认证不通过,可能原因:权威比对源未留存底库照片。
204 公安网人脸比对不一致。 认证不通过,可能原因:不是同一个人或活体照片质量较低。
205 活体检测发现风险。 认证不通过,可能原因:存在攻击风险。
206 业务策略限制。 认证不通过,可能原因:用户存在异常操作风险。
207 人脸与身份证头像不一致。 认证不通过,可能原因:人脸与身份证头像不一致。
208 身份证照片翻拍。 认证不通过,可能原因:提交的身份证照片非身份证原照片、未提交有效身份证照片、提交的是身份证复印件。
209 权威比对源异常。 认证不通过,可能原因:权威比对源异常,无法比对。
210 设备风险。 认证不通过,可能原因:设备存在安全风险。
211 安全策略风险。 认证不通过,可能原因:用户的业务存在安全风险。

ResultObject.MaterialInfo.riskInfo补充说明

ResultObject.MaterialInfo.riskInfo包含风险分值(score)和风险标签(tags)两个参数,具体说明如下:
  • 风险分值(score)的取值范围是0~100,值越大表示行为的风险程度越大。
    • 在营销安全和注册安全场景下,风险分值(score)的映射表如下。
      值区间 风险等级 建议操作
      [0,35) 低风险 放行。
      [35,65) 中风险 打标观察。
      [65,85) 中高风险 需要进一步安全验证或限制使用权限。
      [85,100) 高风险 限制使用权限。
    • 在金融安全场景下,风险分值(score)的映射表如下。
      值区间 风险等级 建议操作
      [0,35) 低风险 放行。
      [35,70) 中风险 打标观察。
      [70,100) 高风险 限制使用权限。
  • 风险标签(tags)的说明如下表所示。
    业务场景类型(Mode) tags取值 说明
    营销安全(MARKET_SAFE)和注册安全(ACCOUNT_SAFE) rm0101、rm0102、rm0103、rm0111、rm0112、rm0113、rm0114 risky_mobile,表示手机号风险。
    rn0301、rn0302、rn0303、rn0311、rn0312、rn0313、rn0315 risky_net,表示网络风险。
    rd0401、rd0402、rd0411、rd0412 risky_device,表示设备风险。
    ra0601、ra0602、ra0603 risky_activities,表示活动风险。
    金融安全(FINANCE_SAFE) md000、md010、md020、md030 risky_finance,表示金融风险。
ResultObject.MaterialInfo.deviceInfo补充说明
业务场景类型 tags取值 说明
所有业务场景类型 is_emulator 设备疑似是模拟器。该标签支持Android和iOS系统。
is_rooted 设备疑似被root。该标签仅支持Android系统。
is_virtual 设备疑似多开环境。该标签仅支持Android系统。
is_tampered 设备疑似被篡改设备信息。该标签仅支持Android系统。
is_deviceCluster_h 设备疑似为群控高风险设备。该标签仅支持Android系统。
is_deviceCluster_m 设备疑似为群控设备中风险。该标签仅支持Android系统。
no_tag 未发现风险特征。

示例

请参见Java SDK调用示例

说明 如果您需要其他语言的SDK代码示例,您可以通过OpenAPI Explorer在线调试工具调试API接口。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

错误码

Code Message 描述
200 success 接口响应成功。
400 参数不能为空 参数不能为空。
406 无效的certifyId 无效的CertifyId
410 未开通服务 未开通OSS产品或未完成OSS读写授权。具体操作,请参见授权增强版实人认证访问OSS空间
411 RAM无权限 需要为RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。
424 身份认证记录不存在 CertifyId还没有对应的身份认证提交记录。
500 系统错误 系统内部错误。