金融級實人認證服務提供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)刷臉失敗 |