本文介绍如何通过CheckResult接口查询认证结果。
接口说明
接口名:CheckResult
请求方法:HTTPS POST
接口说明:当您收到回调通知之后,可以在服务端通过该接口获取相应的认证状态和认证资料。
重要ID Verification服务结果默认存储30天,超期系统自动删除,请您在认证结束后的30天内查询认证结果。
QPS限量:API独享QPS限量,详情请参见ID Verification服务端API QPS限量说明。
服务地址:
说明内网访问优势:内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域,请使用内网域名访问 ID Verification 服务,以获得更安全、稳定的通信质量。
海外访问优化建议:海外网络环境复杂,建议参考服务端网络耗时分析与优化,优化集成方案,降低网络延迟及请求失败概率。
中国香港
公网:
cloudauth-intl.cn-hongkong.aliyuncs.com内网:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
在线调试和集成
在调试和集成前,请确保您已完整阅读使用OpenAPI调试和集成服务端API文档,充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。
您可以在OpenAPI Explorer中直接运行本接口进行调试,并生成本接口的SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
MerchantBizId | String | Yes | 您自定义的业务唯一标识,用于后续定位排查问题。支持长度为32位的字母和数字的组合,请确保唯一。 说明 阿里云服务器不会对该字段的值进行唯一性检查。为了更好地跟踪,强烈建议保证字段唯一性。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
TransactionId | String | Yes | 整个认证流程的唯一标识。该值需要调用 Initialize 接口获取。 重要 为避免篡改风险,该值必须使用您Initialize接口时服务端存储的TransactionId,不建议使用客户端回调的TransactionId。 | hksb7ba1b28130d24e015d6******** |
IsReturnImage | String | No | 是否需要返回认证图片资料:
| Y |
返回数据
名称 | 类型 | 描述 | 示例值 | |
HTTP Status Code | Integer | HTTP状态码。 | 200 | |
HTTP Body | RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Code | String | Success | ||
Message | String | 返回Code的详细描述。 | success | |
Result.Passed | String | 认证最终结果,取值:
| Y | |
Result.SubCode | String | 认证结果描述。更多信息,请参见ResultObject.SubCode错误码说明。 | 200 | |
Result.ExtFaceInfo | String | 活体人脸验证相关结果信息。关于JSON格式,请参见右侧示例。更多信息,请参见ExtFaceInfo。 | | |
ExtFaceInfo
名称 | 类型 | 描述 | 示例值 |
faceImg | String | 采集人脸图片,Base64格式。如在发起接口请求时,参数 | base64格式 |
faceAttack | String | 采集人脸是否涉及活体攻击:
| N |
faceQuality | Double | 活体人脸质量分数。取值范围0~100。 | 99.99 |
faceOcclusion | String | 是否有脸部遮挡:
| N |
docVideoUrl | String | 存证OSS下载地址。 说明
| https://aliyun-cloudauth.oss-aliyuncs.com/******.webm |
faceAge | String | 人脸预测的参考年龄,可能存在预测失败无法返回的情况。 | 30 |
faceGender | String | 人脸图片预测的性别,可能存在预测失败无法返回的情况。
| M |
faceAttackScore | Double | 人脸识别算法预测的假脸攻击可能性,分数越高代表假脸的可能性越高。 分值取值:0~100。 | 80 |
guardRiskScore | Double | 人脸保镖算法预测的设备风险可能性,分数越高代表设备风险越高。 分值取值:0~100。 | 90 |
deviceToken | String | 设备助手DeviceToken,当SDK完整集成设备助手模块时返回,可通过该Token 查询设备助手服务端接口,获取设备风险详情。
| e0c34a77f5ac40a5aa5e6ed20c35**** |
返回Code
HTTP状态码 | Code | Message描述 |
200 | Success | 请求成功。 |
400 | MissingParameter | 参数不能为空。 |
InvalidParameter | 非法参数。 | |
TransactionIdInvalid | 无效Transaction id。 | |
403 | Forbidden.RAMUserAccessDenied | 需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息,请参见授权RAM用户访问服务。 |
Forbidden.AccountAccessDenied | 确保您开通了ID verifycation,并且保证账户未欠费。 | |
Throttling.Api | API限流拦截。 | |
404 | ProcessNotCompleted | 整个认证流程未完成。 |
500 | InternalError | 系统内部错误,请反馈工程师排查。 |
503 | ServiceUnavailable | 服务不可用,请反馈工程师排查。 |
ResultObject.SubCode错误码说明
错误码 | 认证记录是否计费 | 描述和原因建议 |
200 | 是 | 认证通过。 |
205 | 是 | 活体检测存在风险。 |
206 | 是 | 业务策略限制。 说明 开启安全模式后,会对认证的设备等环境进行安全检测,若检测到可能存在风险,将判定认证结果不通过。您可以提醒用户卸载设备上可能安装的各种多开、分身、虚拟环境等软件或插件,恢复设备系统初始安全环境后重试。 |