APICloud客户端接入

接入前必读

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

前提条件

已在APICloud官网中创建应用。

配置依赖

1. 下载增强版实人认证APICloud SDK，解压可获得iOS模块和Android模块。
   上传自定义模块选择上传文档时，分别选择iOS模块和Android模块对应目录下的文件。
2. 在APICloud Studio界面中，上传增强版实人认证APICloud模块。
   1. 进入APICloud Studio界面，在左侧导航栏，单击图标。
   2. 在模块页面，单击自定义模块页签。
   3. 在自定义模块页签，输入有效的模块名称、模块概要及版本号，选择并上传已下载的APICloud模块。

      模块名称建议填写IdentityPlatformApiCloud。

      
   4. 单击保存。
      自定义模块上传成功后，您可以在自定义模块页签的下方看到已上传的模块。
3. 在APICloud Studio界面中，将APICloud模块添加到项目中。
   在自定义模块页签页签，单击已上传APICloud模块右上角的图标，将APICloud模块添加到项目中。

   说明 自定义模块仅对自己的账号可见。如果需要对外开放，您可以在模块管理页面提交该模块，官方审核通过后将会发布到模块库。

   当您需要更新已上传的自定义模块时，可以通过已上传自定义模块右上角的图标，重新上传自定义模块包，然后单击保存。

4. 调用增强版实人认证服务。
   1. 获取MetaInfo数据。
      您在调用增强版实人认证服务端发起认证请求时需要传入该值。
   2. 开始认证。调用认证接口（faceVerify函数），传入CertifyId进行认证（CertifyId通过接口InitSmartVerify获取）。
      参数说明如下表所示。

      名称	类型	描述
      certifyId	String	认证的唯一标识。
      extParams	Map<String, String>	用户自定义参数，可以为空。关于自定义的字段，请参见下表所示。

      用户自定义参数extParams支持的字段说明。

      名称	描述	示例值
      kIdentityParamKeyShowResult	是否需要展示OCR识别结果确认页。取值： YES：要展示OCR识别结果确认页。 NO：不展示OCR识别结果确认页。	YES
      kIdentityParamKeyWaterMark	自定义证件图片水印文字。默认文字为仅供业务使用。	仅供业务使用
      kIdentityParamKeyIdCardFaceOnly	是否仅识别身份证人像面。取值： YES：仅识别身份证人像面。 NO：识别身份证人像面和国徽面。	NO
      kIdentityParamKeyScanMaxTime	OCR证件扫描的超时时间，单位为秒，默认30秒。	30
      kIdentityParamKeyValidIdCardDate	是否校验身份证有效期。取值： YES：校验身份证有效期。 NO：不校验身份证有效期。 说明 当kIdentityParamKeyIdCardFaceOnly取值为NO时该参数生效。	YES
      kIdentityParamKeyNextButtonColor	OCR识别结果确认页底部按钮的底色。	#FF0000
      kIdentityParamKeyOcrMode	OCR模式。取值： PHOTO（默认）：拍照模式。 SCAN：扫描模式。	PHOTO
      kIdentityParamKeyOcrSelectPhoto	是否展示从相册选择图片的功能，取值： YES（默认）：展示从相册选择照片的功能。 NO：不展示从相册选择照片的功能。	YES

代码示例

• 获取MetaInfo数据：

  <script>
      //加载增强版实人认证插件。
    <script type="text/javascript">
      apiready = function(){
        //自定义模块的名称。
      var identityPlugin = api.require('IdentityPlatformApiCloud');
      var metaInfo = identityPlugin.getMetaInfo();
      };
  </script>
  </script>

• 增强版实人认证服务代码示例：

  identityPlugin.faceVerify({
    "certifyId":"xxxxxxxxxx"    //填写从服务端获取的CertifyId。
  }, function(ret, err){
    console.log('认证结果=>' + ret.code + ' reason=>' + ret.message);
  });

  响应结果示例：

  {
                      code:1000,    //错误码。
                      message:认证通过,    //错误码描述。
                      deviceToken:xxx,    //设备Token（如果需要则获取本字段）。
                      faceImage:xxx,     //本地返回的人脸照片（如果需要则获取本字段）。
                      ocrInfo:xxx      //OCR识别结果信息（如果需要则获取本字段）。
                  }

错误码说明