本文介绍了增强版活体验证方案的Java SDK调用示例。

SDK使用说明

如果需要其他语言的SDK示例代码,您可以通过OpenAPI 开发者门户在线调试工具调试API接口。该工具会自动生成相应API的SDK调用示例代码,详细信息,请参见:

本章节提供的是最新版本的Java SDK调用示例,如果您需要查看之前版本,请参见Java SDK调用示例(V1版本)

前提条件

使用Maven引入SDK

<dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>cloudauth20200618</artifactId>
            <version>1.0.5</version>
</dependency>

调用示例

InitSmartVerify接口调用示例

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

import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.InitSmartVerifyRequest;
import com.aliyun.cloudauth20200618.models.InitSmartVerifyResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

public class InitSmartVerify {

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

        // 通过以下代码创建API请求并设置参数。
        InitSmartVerifyRequest request = new InitSmartVerifyRequest();
        // 请输入场景ID+L。
        request.setSceneId(<xxxxL>);
        request.setOuterOrderNo("<商户请求的唯一标识>");
        // 卡证核身类型,固定值。
        request.setMode("LOGIN_SAFE");
        // 证件类型,固定值。
        request.setCertType("IDENTITY_CARD");
        // request.setCertName("<张三>");
        // request.setCertNo("<xxx>");
        // MetaInfo环境参数,需要通过客户端SDK获取。
        request.setMetaInfo(
            "{\"apdidToken\":\"\",\"appName\":\"com.aliyun.identity.platform\",\"appVersion\":\"1.0\","
                + "\"bioMetaInfo\":\"5.1.0:11501568,4\",\"deviceModel\":\"JKM-AL00b\",\"deviceType\":\"android\","
                + "\"osVersion\":\"9\",\"zimVer\":\"1.0.0\"}");
        request.setMobile("<xxx>");
        //request.setIp("<114.xxx.xxx.xxx>");
        //request.setUserId("<12345xxxx>");
        //request.setCallbackUrl("<https://www.aliyun.com>");
        //request.setCallbackToken("<NMjvQanQgplBSaEI0sL86WnQplB>");

        // 请在以下四种方式中选择其一。
        // 1.人脸图片的Base64编码。
        // 2.已授权OSS空间的Bucket名和已授权OSS空间的文件名。
        // 3.人脸图片的HTTPS或HTTP地址。
        // 4.已通过智能核身得到的CertifyId,认证时的图片作为比对图片。

        // 方式一:人脸图片的Base64编码。
        // request.setFacePictureBase64("</9j/4AAQSkZJRgABAQAASxxxxxxx>");
        // 方式二:已授权OSS空间的Bucket名和已授权OSS空间的文件名。
        // request.setOssBucketName("<cn-shanghai-aliyun-cloudauth-xxxxx>");
        // request.setOssObjectName("<verify/xxxxx/xxxxxx.jpeg>");
        // 方式三:人脸图片的HTTPS或HTTP地址。
        request.setFacePictureUrl("<https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg>");
        // 方式四:已通过智能核身得到的CertifyId,认证时的图片作为比对图片。
        // request.setCertifyId("<0bfa7c493f850e5178b9f8613634c9xx>");

        // 推荐,支持服务路由。
        InitSmartVerifyResponse response = initSmartVerifyAutoRoute(request);

        // 不支持服务自动路由。
        //InitSmartVerifyResponse response = initSmartVerify("cloudauth.cn-shanghai.aliyuncs.com", request);

        System.out.println(response.getRequestId());
        System.out.println(response.getCode());
        System.out.println(response.getMessage());
        System.out.println(response.getResultObject() == null ? null
            : response.getResultObject().getCertifyId());
    }

    private static InitSmartVerifyResponse initSmartVerifyAutoRoute(InitSmartVerifyRequest request) {
        // 第一个为主区域Endpoint,第二个为备区域Endpoint。
        List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
            "cloudauth.cn-beijing.aliyuncs.com");
        InitSmartVerifyResponse lastResponse = null;
        for (String endpoint : endpoints) {
            try {
                InitSmartVerifyResponse response = initSmartVerify(endpoint, request);
                lastResponse = response;

                // 服务端错误,切换到下个区域调用。
                if ("500".equals(response.getCode())) {
                    continue;
                }

                return response;
            } catch (Exception e) {
                // 网络异常,切换到下个区域调用。
                if (e.getCause() instanceof TeaException) {
                    TeaException teaException = ((TeaException)e.getCause());
                    if (teaException.getData() != null && "ServiceUnavailable".equals(
                        teaException.getData().get("Code"))) {
                        continue;
                    }
                }

                if (e.getCause() instanceof TeaUnretryableException) {
                    continue;
                }
            }
        }

        return lastResponse;
    }

    private static InitSmartVerifyResponse initSmartVerify(String endpoint, InitSmartVerifyRequest request)
        throws Exception {
        Config config = new Config();
        config.setAccessKeyId("<您的AccessKey ID>");
        config.setAccessKeySecret("<您的AccessKey Secret>");
        config.setEndpoint(endpoint);
        // 设置HTTP代理。
        //config.setHttpProxy("<http://xxx.xx.xx.xx:xxxx>");
        // 设置HTTPS代理。
        //config.setHttpsProxy("<https://xxx.xx.xx.xx:xxxx>");
        Client client = new Client(config);

        // 创建RuntimeObject实例并设置运行参数。
        RuntimeOptions runtime = new RuntimeOptions();
        runtime.readTimeout = 10000;
        runtime.connectTimeout = 10000;

        return client.initSmartVerify(request, runtime);
    }
}

DescribeSmartVerify接口调用示例

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

import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.DescribeSmartVerifyRequest;
import com.aliyun.cloudauth20200618.models.DescribeSmartVerifyResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

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

        // 通过以下代码创建API请求并设置参数。
        DescribeSmartVerifyRequest request = new DescribeSmartVerifyRequest();
        // 请输入场景ID+L。
        request.setSceneId(<xxxxL>);

        request.setCertifyId("<91707dc296d469ad38e4c5efa6a0xxxx>");

        // 推荐,支持服务路由。
        //DescribeSmartVerifyResponse response = describeSmartVerifyAutoRoute(request);

        // 不支持服务自动路由。
        DescribeSmartVerifyResponse response = describeSmartVerify("cloudauth.cn-shanghai.aliyuncs.com", request);

        System.out.println(response.getRequestId());
        System.out.println(response.getCode());
        System.out.println(response.getMessage());
        System.out.println(
            response.getResultObject() == null ? null : response.getResultObject().getPassed());
        System.out.println(
            response.getResultObject() == null ? null : response.getResultObject().getSubCode());
        System.out.println(response.getResultObject() == null ? null
            : response.getResultObject().getMaterialInfo());
    }

    private static DescribeSmartVerifyResponse describeSmartVerifyAutoRoute(DescribeSmartVerifyRequest request) {
        // 第一个为主区域Endpoint,第二个为备区域Endpoint。
        List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
            "cloudauth.cn-beijing.aliyuncs.com");
        DescribeSmartVerifyResponse lastResponse = null;
        for (String endpoint : endpoints) {
            try {
                DescribeSmartVerifyResponse response = describeSmartVerify(endpoint, request);
                lastResponse = response;

                // 服务端错误,切换到下个区域调用。
                if ("500".equals(response.getCode())) {
                    continue;
                }

                return response;
            } catch (Exception e) {
                // 网络异常,切换到下个区域调用。
                if (e.getCause() instanceof TeaException) {
                    TeaException teaException = ((TeaException)e.getCause());
                    if (teaException.getData() != null && "ServiceUnavailable".equals(
                        teaException.getData().get("Code"))) {
                        continue;
                    }
                }

                if (e.getCause() instanceof TeaUnretryableException) {
                    continue;
                }
            }
        }

        return lastResponse;
    }

    private static DescribeSmartVerifyResponse describeSmartVerify(String endpoint, DescribeSmartVerifyRequest request)
        throws Exception {
        Config config = new Config();
        config.setAccessKeyId("<您的AccessKey ID>");
        config.setAccessKeySecret("<您的AccessKey Secret>");
        config.setEndpoint(endpoint);
        // 设置HTTP代理。
        //config.setHttpProxy("<http://xx.xx.xx.xx:xxxx>");
        // 设置HTTPS代理。
        //config.setHttpsProxy("<https://xx.xx.xx.xx:xxxx>");
        Client client = new Client(config);

        // 创建RuntimeObject实例并设置运行参数。
        RuntimeOptions runtime = new RuntimeOptions();
        runtime.readTimeout = 10000;
        runtime.connectTimeout = 10000;

        return client.describeSmartVerify(request, runtime);
    }
}