SDK使用說明

如果需要其他語言的SDK示例代碼，您可以通過OpenAPI 開發(fā)者門戶在線調(diào)試工具調(diào)試API接口，該工具會自動生成相應(yīng)API的SDK調(diào)用示例代碼。您可以單擊以下接口鏈接進(jìn)行調(diào)試：

調(diào)試LivenessFaceVerify接口

本章節(jié)提供的是最新版本的Java SDK調(diào)用示例，如果您需要查看之前版本，請參見Java SDK調(diào)用示例（V1版本）。

前提條件

需要使用的Java為1.8及以上版本。

使用Maven引入SDK

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

調(diào)用示例

import com.aliyun.cloudauth20190307.Client;
import com.aliyun.cloudauth20190307.models.LivenessFaceVerifyRequest;
import com.aliyun.cloudauth20190307.models.LivenessFaceVerifyResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

import java.util.Arrays;
import java.util.List;

public class LivenessFaceVerify {
    public static void main(String[] args) throws Exception {

        // 通過以下代碼創(chuàng)建API請求并設(shè)置參數(shù)。
        LivenessFaceVerifyRequest request = new LivenessFaceVerifyRequest();
        // 請輸入場景ID+L。
        request.setSceneId(0L);
        request.setOuterOrderNo("商戶請求的唯一標(biāo)識");
        request.setProductCode("LR_FR_MIN");
        // 卡證核身類型，固定值。
        request.setModel("FRONT_CAMERA_LIVENESS");
        //request.setDeviceToken("xxxx");
        //request.setMobile("130xxxxxxxx");
        //request.setIp("114.xxx.xxx.xxx");
        //request.setUserId("12345xxxx");
        // 請?jiān)谝韵路绞街羞x擇一種，傳入人臉圖片。
        // 方式一：人臉圖片Base64。
        request.setFaceContrastPicture("人臉圖片Base64編碼");
        // 方式二：人臉圖片OSS bucket名和文件名。
        //request.setOssBucketName("cn-shanghai-aliyun-cloudauth-xxxxx");
        //request.setOssObjectName("verify/xxxxx/xxxxxx.jpeg");
        // 方式三：人臉圖片的OSS URL地址。該地址必須公網(wǎng)可訪問。
        //request.setFaceContrastPictureUrl("https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg");

        // 推薦，支持服務(wù)路由。
        LivenessFaceVerifyResponse response = livenessFaceVerifyAutoRoute(request);

        // 不支持服務(wù)自動路由。
        //LivenessFaceVerifyResponse response = livenessFaceVerify("cloudauth.cn-shanghai.aliyuncs.com", 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().getMaterialInfo());
    }

    private static LivenessFaceVerifyResponse livenessFaceVerifyAutoRoute(LivenessFaceVerifyRequest request) {
        // 第一個(gè)為主區(qū)域Endpoint，第二個(gè)為備區(qū)域Endpoint。
        List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com", "cloudauth.cn-beijing.aliyuncs.com");
        LivenessFaceVerifyResponse lastResponse = null;
        for (int i=0; i<endpoints.size(); i++) {
            try {
                LivenessFaceVerifyResponse response = livenessFaceVerify(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 response;
            } catch (Exception e) {
                e.printStackTrace();
                if(i == endpoints.size()-1){
                    throw new RuntimeException(e);
                }
            }
        }

        return lastResponse;
    }

    private static LivenessFaceVerifyResponse livenessFaceVerify(String endpoint, LivenessFaceVerifyRequest request)
            throws Exception {
        // 阿里云賬號AccessKey擁有所有API的訪問權(quán)限，建議您使用RAM用戶進(jìn)行API訪問或日常運(yùn)維。
        // 強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號下所有資源的安全。
        // 本示例通過阿里云Credentials工具從環(huán)境變量中讀取AccessKey，來實(shí)現(xiàn)API訪問的身份驗(yàn)證。如何配置環(huán)境變量，請參見http://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è)置https代理。
        //config.setHttpsProxy("https://xx.xx.xx.xx:xxxx");
        // 設(shè)置http代理。
        //config.setHttpProxy("http://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.livenessFaceVerifyWithOptions(request, runtime);
    }
}