APICloud接入

金融级实人认证服务提供APICloud插件,帮助您在业务应用(App)中实现刷脸认证功能。您可以通过应用服务端认证初始化接口,向阿里云服务器调用发起认证请求接口并获取刷脸认证的唯一标识CertifyId,然后使用CertifyId唤起刷脸认证客户端SDK。本文介绍了APICloud客户端接入的操作方法。

背景信息

低代码平台APICloud的模块库提供多种模块。您可以使用已有模块,在应用中快速部署集成,缩短开发流程。当已有模块无法满足特殊需求时,您也可以自定义相关模块。

接入前必读

近期发现有个人开发者封装阿里云实人认证SDK后开发了第三方插件,并在某平台上提供付费下载服务。阿里云提醒您,如果您使用了此类非阿里云官方提供的插件或服务,阿里云概不对由此造成的一切后果负责,亦不承担任何法律责任。建议您使用阿里云官方SDK服务。

前提条件

已在APICloud官网|用友开发者中心控制台中创建应用。

配置依赖

  1. 下载APICloud SDK并解压。

    解压后即可获得iOS插件和Android插件。

  2. 在移动开发控制台的目标应用页面,上传APICloud插件。

    1. 移动插件页签,单击自定义插件页签。

    2. 自定义插件页签单击上传自定义插件

    3. 上传自定义插件对话框,输入插件名称中文名称插件描述版本号,并上传iOS插件和Android插件对应目录下的文件,单击提交

      image.png
  3. 将APICloud插件添加到项目中。

    说明

    自定义插件仅对您当前登录的账号可见。

    1. 移动插件页签,单击自定义插件页签。

    2. 在已上传的APICloud插件操作列,单击添加至本应用

      image.png

      当您需要更新已上传的自定义插件时,可以在操作列,单击更新,并重新上传自定义插件,然后单击提交

  4. 调用金融级实人认证服务。

    1. 获取MetaInfo数据。

      MetaInfo为环境参数,您在调用服务端接口(InitFaceVerify)发起认证请求时需要传入该值。

    2. 开始认证。

      调用认证接口(verify函数),传入certifyId进行认证。

      certifyId参数说明如下:

      名称

      类型

      描述

      certifyId

      String

      实人认证唯一标识,需通过服务端初始化认证接口(InitFaceVerify)获取。

      说明

      每个certifyId只能调用一次verify函数,每次调用verify函数之前都必须重新获取certifyId

代码示例

  1. 获取MetaInfo数据。

    <script type="text/javascript">
      apiready = function(){
        // 加载金融级实人认证服务插件
        aliyunVerifyModule = api.require('AliyunVerifyFinancial');
        // 调用getMetaInfos获取metaInfo数据
        aliyunVerifyModule.getMetaInfos(null, function(metaInfo, err) {
            alert(JSON.stringify(metaInfo));
        });
      };
    </script>
  2. 开始认证。

    <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)刷脸失败