金融级实人认证服务提供APICloud插件,帮助您在业务应用(App)中实现刷脸认证功能。您可以通过应用服务端认证初始化接口,向阿里云服务器调用发起认证请求接口并获取刷脸认证的唯一标识CertifyId,然后使用CertifyId唤起刷脸认证客户端SDK。本文介绍了APICloud客户端接入的操作方法。
背景信息
低代码平台APICloud的模块库提供多种模块。您可以使用已有模块,在应用中快速部署集成,缩短开发流程。当已有模块无法满足特殊需求时,您也可以自定义相关模块。
接入前必读
近期发现有个人开发者封装阿里云实人认证SDK后开发了第三方插件,并在某平台上提供付费下载服务。阿里云提醒您,如果您使用了此类非阿里云官方提供的插件或服务,阿里云概不对由此造成的一切后果负责,亦不承担任何法律责任。建议您使用阿里云官方SDK服务。
前提条件
已在APICloud官网|用友开发者中心控制台中创建应用。
配置依赖
下载APICloud SDK并解压。
解压后即可获得iOS插件和Android插件。
在移动开发控制台的目标应用页面,上传APICloud插件。
在移动插件页签,单击自定义插件页签。
在自定义插件页签,单击上传自定义插件。
在上传自定义插件对话框,输入插件名称、中文名称、插件描述及版本号,并上传iOS插件和Android插件对应目录下的文件,单击提交。
将APICloud插件添加到项目中。
说明自定义插件仅对您当前登录的账号可见。
在移动插件页签,单击自定义插件页签。
在已上传的APICloud插件操作列,单击添加至本应用。
当您需要更新已上传的自定义插件时,可以在操作列,单击更新,并重新上传自定义插件,然后单击提交。
调用金融级实人认证服务。
获取MetaInfo数据。
MetaInfo为环境参数,您在调用服务端接口(InitFaceVerify)发起认证请求时需要传入该值。
开始认证。
调用认证接口(verify函数),传入certifyId进行认证。
certifyId参数说明如下:
名称
类型
描述
certifyId
String
实人认证唯一标识,需通过服务端初始化认证接口(InitFaceVerify)获取。
说明每个certifyId只能调用一次verify函数,每次调用verify函数之前都必须重新获取certifyId。
代码示例
获取MetaInfo数据。
<script type="text/javascript"> apiready = function(){ // 加载金融级实人认证服务插件 aliyunVerifyModule = api.require('AliyunVerifyFinancial'); // 调用getMetaInfos获取metaInfo数据 aliyunVerifyModule.getMetaInfos(null, function(metaInfo, err) { alert(JSON.stringify(metaInfo)); }); }; </script>
开始认证。
<script type="text/javascript"> // 填写从服务端InitFaceVerify获取的certifyId var param = {"certifyId":"xxx"}; aliyunVerifyModule.verify(param, function(ret, err) { console.log('认证结果=>' + ret.code + ' reason=>' + ret.message); }); </script>
响应结果:
{ code:1000, //返回Code message:认证通过 //Code描述 }
Code说明
Code | 描述 |
1000 | (ZIMResponseSuccess)刷脸成功 |
1001 | (ZIMInternalError)系统错误 |
1003 | (ZIMInterrupt)验证中断 |
2002 | (ZIMNetworkfail)网络错误 |
2003 | (ZIMTIMEError)客户端设备时间错误 |
2006 | (ZIMResponseFail)刷脸失败 |