调用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 | 认证是否通过,取值:
说明 如果接口异常或接口是未认证状态,则不返回该参数。
|
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} } | 认证主体附件信息中的认证信息。结构如下:
|
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) 高风险 限制使用权限。
- 在营销安全和注册安全场景下,风险分值(score)的映射表如下。
- 风险标签(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 | 系统错误 | 系统内部错误。 |