集成須知

服務(wù)端需要集成的兩個(gè)接口

InitFaceVerify-發(fā)起認(rèn)證請(qǐng)求

每次開始認(rèn)證前通過(guò)調(diào)用本接口獲取用于瀏覽器進(jìn)行實(shí)人認(rèn)證的認(rèn)證鏈接CertifyUrl和每次認(rèn)證的唯一CertifyId。

須將此接口的請(qǐng)求封裝為開始認(rèn)證的業(yè)務(wù)接口，供網(wǎng)頁(yè)端調(diào)用。

{
    "appVersion": "1",
    "bioMetaInfo": "4.1.0:1150****,0",
    "appName": "com.aliyun.antcloudauth",
    "deviceType": "ios",
    "osVersion": "iOS 10.3.2",
    "apdidToken": "",
    "deviceModel": "iPhone9,1"
}

DescribeFaceVerify-獲取認(rèn)證詳細(xì)數(shù)據(jù)

當(dāng)您收到回調(diào)通知之后，可以在服務(wù)端通過(guò)該接口獲取相應(yīng)的認(rèn)證狀態(tài)和認(rèn)證資料。

{
"number":"610***********1110",
"name":"王先生",
"verifyName":"王先"
}

SDK調(diào)用示例

阿里云提供了OpenAPI門戶，可以使用網(wǎng)頁(yè)或命令行方式預(yù)先驗(yàn)證接口，您可以通過(guò)下面的鏈接進(jìn)入調(diào)試：

• InitFaceVerify調(diào)試入口

• DescribeFaceVerify調(diào)試入口

SDK集成

Java語(yǔ)言為例，要求JDK 1.8及以上版本。

1. 在pom.xml中添加如下依賴，即可在Maven工程中使用SDK。

   • Java SDK依賴。以下依賴版本僅供參考，建議在實(shí)際配置時(shí)獲取最新依賴版本。

     <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>cloudauth20190307</artifactId>
      <version>2.7.2</version>
     </dependency>

   • 身份驗(yàn)證依賴。請(qǐng)查看ChangeLog.txt獲取所有已發(fā)布的版本列表（建議使用最新的版本）。

     <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>credentials-java</artifactId>
        <version>LATEST</version>
     </dependency>

     說(shuō)明

     本示例通過(guò)阿里云Credentials工具從環(huán)境變量中讀取AccessKey，來(lái)實(shí)現(xiàn)API訪問(wèn)的身份驗(yàn)證。您需要提前在系統(tǒng)配置環(huán)境變量，具體操作，請(qǐng)參見身份驗(yàn)證配置。

2. 接口調(diào)用示例。

   重要

   調(diào)用示例中僅設(shè)定了必要參數(shù)，詳細(xì)參數(shù)請(qǐng)參見InitFaceVerify-發(fā)起認(rèn)證請(qǐng)求和DescribeFaceVerify-獲取認(rèn)證詳細(xì)數(shù)據(jù)。

   InitFaceVerify接口調(diào)用示例

   import java.util.Arrays;
   import java.util.List;
   
   import com.aliyun.cloudauth20190307.Client;
   import com.aliyun.cloudauth20190307.models.*;
   import com.aliyun.teaopenapi.models.Config;
   import com.aliyun.teautil.models.RuntimeOptions;
   
   public class InitFaceVerify {
   
       public static void main(String[] args) throws Exception {
   
           InitFaceVerifyRequest request = new InitFaceVerifyRequest();
           // 場(chǎng)景ID+L。
           request.setSceneId(100000xxxxL);
           // 設(shè)置商戶請(qǐng)求的唯一標(biāo)識(shí)。
           request.setOuterOrderNo("xxxx");
           // 認(rèn)證方案。
           request.setProductCode("ID_PRO");
           // 模式。
           request.setModel("LIVENESS");
           request.setCertType("IDENTITY_CARD");
           request.setCertName("張先生");
           request.setCertNo("xxxx");
           // MetaInfo環(huán)境參數(shù)，此參數(shù)應(yīng)由前端js獲取并傳入。
           request.setMetaInfo("{}");
           //業(yè)務(wù)頁(yè)面回跳的目標(biāo)地址。
           request.setReturnUrl("https://www.aliyundoc.com");
   
           InitFaceVerifyResponse response = initFaceVerifyAutoRoute(request);
   
           response.getBody().getRequestId();
           response.getBody().getResultObject().getCertifyId();
           System.out.println(response.getBody().getRequestId());
           System.out.println(response.getBody().getCode());
           System.out.println(response.getBody().getMessage());
           System.out.println(response.getBody().getResultObject() == null ? null
                   : response.getBody().getResultObject().getCertifyId());
       }
   
       private static InitFaceVerifyResponse initFaceVerifyAutoRoute(InitFaceVerifyRequest request) {
           // 第一個(gè)為主區(qū)域Endpoint，第二個(gè)為備區(qū)域Endpoint。
           List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com", "cloudauth.cn-beijing.aliyuncs.com");
           InitFaceVerifyResponse lastResponse = null;
           for (int i=0; i<endpoints.size(); i++) {
               try {
                   InitFaceVerifyResponse response = initFaceVerify(endpoints.get(i), request);
                   lastResponse = response;
   
                   // 服務(wù)端錯(cuò)誤，切換到下個(gè)區(qū)域調(diào)用。
                   if(response != null){
                       if(500 == response.getStatusCode()){
                           continue;
                       }
                       if(response.getBody() != null){
                           if("500".equals(response.getBody().getCode())){
                               continue;
                           }
                       }
                   }
   
                   // 正常返回
                   return lastResponse;
               }catch (Exception e) {
                   e.printStackTrace();
                   if(i == endpoints.size()-1){
                       throw new RuntimeException(e);
                   }
               }
           }
   
           return lastResponse;
       }
   
       private static InitFaceVerifyResponse initFaceVerify(String endpoint, InitFaceVerifyRequest request)
               throws Exception {
           // 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限，建議您使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維。
           // 強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號(hào)下所有資源的安全。
           // 本示例通過(guò)阿里云Credentials工具從環(huán)境變量中讀取AccessKey，來(lái)實(shí)現(xiàn)API訪問(wèn)的身份驗(yàn)證。如何配置環(huán)境變量，請(qǐng)參見http://m.bestwisewords.com/document_detail/378657.html。
           com.aliyun.credentials.Client credentialClient = new com.aliyun.credentials.Client();
           Config config = new Config();
           config.setCredential(credentialClient);
           config.setEndpoint(endpoint);
           // 設(shè)置http代理。
           //config.setHttpProxy("http://xx.xx.xx.xx:xxxx");
           // 設(shè)置https代理。
           //config.setHttpsProxy("https://xx.xx.xx.xx:xxxx");
           Client client = new Client(config);
   
           // 創(chuàng)建RuntimeObject實(shí)例并設(shè)置運(yùn)行參數(shù)。
           RuntimeOptions runtime = new RuntimeOptions();
           runtime.readTimeout = 10000;
           runtime.connectTimeout = 10000;
   
           return client.initFaceVerifyWithOptions(request, runtime);
       }
   
   }

   DescribeFaceVerify接口調(diào)用示例

   import java.util.Arrays;
   import java.util.List;
   
   import com.aliyun.cloudauth20190307.Client;
   import com.aliyun.cloudauth20190307.models.DescribeFaceVerifyRequest;
   import com.aliyun.cloudauth20190307.models.DescribeFaceVerifyResponse;
   import com.aliyun.teaopenapi.models.Config;
   import com.aliyun.teautil.models.RuntimeOptions;
   
   public class DescribeFaceVerify {
   
       public static void main(String[] args) throws Exception {
           
           // 創(chuàng)建API請(qǐng)求并設(shè)置參數(shù)。
           DescribeFaceVerifyRequest request = new DescribeFaceVerifyRequest(); 
           // 場(chǎng)景ID+L。
           request.setSceneId(0L); 
           // CertifyId在InitFaceVerify接口的返回值中。
           request.setCertifyId("xxxx");
      
           DescribeFaceVerifyResponse response = describeFaceVerifyAutoRoute(request);
   
           System.out.println(response.getBody().getRequestId());
           System.out.println(response.getBody().getCode());
           System.out.println(response.getBody().getMessage());
           System.out.println(
                   response.getBody().getResultObject() == null ? null : response.getBody().getResultObject().getPassed());
           System.out.println(
                   response.getBody().getResultObject() == null ? null : response.getBody().getResultObject().getSubCode());
           System.out.println(
                   response.getBody().getResultObject() == null ? null
                           : response.getBody().getResultObject().getIdentityInfo());
           System.out.println(
                   response.getBody().getResultObject() == null ? null
                           : response.getBody().getResultObject().getDeviceToken());
           System.out.println(
                   response.getBody().getResultObject() == null ? null
                           : response.getBody().getResultObject().getMaterialInfo());
       }
   
       private static DescribeFaceVerifyResponse describeFaceVerifyAutoRoute(DescribeFaceVerifyRequest request) {
           // 第一個(gè)為主區(qū)域Endpoint，第二個(gè)為備區(qū)域Endpoint。
           List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com", "cloudauth.cn-beijing.aliyuncs.com");
           DescribeFaceVerifyResponse lastResponse = null;
           for (int i = 0; i < endpoints.size(); i++) {
               try {
                   DescribeFaceVerifyResponse response = describeFaceVerify(endpoints.get(i), request);
                   lastResponse = response;
   
                   // 服務(wù)端錯(cuò)誤，切換到下個(gè)區(qū)域調(diào)用。
                   if (response != null) {
                       if (500 == response.getStatusCode()) {
                           continue;
                       }
                       if (response.getBody() != null) {
                           if ("500".equals(response.getBody().getCode())) {
                               continue;
                           }
                       }
                   }
   
                   return lastResponse;
               } catch (Exception e) {
                   if (i == endpoints.size() - 1) {
                       throw new RuntimeException(e);
                   }
               }
           }
   
           return lastResponse;
       }
   
       private static DescribeFaceVerifyResponse describeFaceVerify(String endpoint, DescribeFaceVerifyRequest request)
               throws Exception {
           // 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限，建議您使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維。
           // 強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號(hào)下所有資源的安全。
           //本示例通過(guò)阿里云Credentials工具從環(huán)境變量中讀取AccessKey，來(lái)實(shí)現(xiàn)API訪問(wèn)的身份驗(yàn)證。如何配置環(huán)境變量，請(qǐng)參見http://m.bestwisewords.com/document_detail/378657.html。
           com.aliyun.credentials.Client credentialClient = new com.aliyun.credentials.Client();
           Config config = new Config();
           config.setCredential(credentialClient);
           config.setEndpoint(endpoint);
   
           Client client = new Client(config);
           
           RuntimeOptions runtime = new RuntimeOptions();
           runtime.readTimeout = 10000;
           runtime.connectTimeout = 10000;
   
           return client.describeFaceVerifyWithOptions(request, runtime);
       }
   }