本文介绍Java SDK集成纯服务端认证方案的操作方法。

SDK使用说明

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

前提条件

  • 需要使用的Java版本在1.8版本及以上。
  • 已添加认证场景,并获取对应的场景ID。具体操作,请参见添加认证场景

使用Maven引入SDK

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

调用示例

  • 方式一:不使用本地图片示例
    import java.util.Arrays;
    import java.util.List;
    
    import com.aliyun.cloudauth20200618.models.ContrastSmartVerifyRequest;
    import com.aliyun.cloudauth20200618.models.ContrastSmartVerifyResponse;
    import com.aliyun.tea.TeaException;
    import com.aliyun.tea.TeaUnretryableException;
    import com.aliyun.tearpc.models.Config;
    import com.aliyun.teautil.models.RuntimeOptions;
    
    public class ContrastSmartVerify {
    
        public static void main(String[] args) throws Exception {
    
            // 通过以下代码创建API请求并设置参数。
            ContrastSmartVerifyRequest request = new ContrastSmartVerifyRequest();
            // 请输入场景ID+L。
            request.setSceneId(xxxL);
            request.setOuterOrderNo("xxx");
            // 增强版实人认证的业务场景类型。取值:
            // CERT_SAFE:纯认证模式。
            // CERT_PHOTO_SAFE:认证及照片防翻拍检测模式。
            // MARKET_SAFE:营销安全(包含认证、防翻拍和营销风险识别功能)。
            // FINANCE_SAFE:金融安全(包含认证、防翻拍和金融风险识别功能)。
            // ACCOUNT_SAFE:注册安全(包含认证、防翻拍和注册风险识别功能)。
            request.setMode("CERT_SAFE");
            request.setCertType("IDENTITY_CARD");
            request.setCertName("xxx");
            request.setCertNo("xxx");
            // 当Mode取值为MARKET_SAFE、FINANCE_SAFE或ACCOUNT_SAFE时,Mobile为必填字段。
            request.setMobile("137xxxxxxxx");
            // 公网可以访问的HTTP、HTTPS链接。
            request.setFacePicUrl("http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg");
            // 使用图片Base64编码方式。
            // request.setFacePicString("xxxxx");
            // 用户网络IP。
            // request.setIp("xx.xx.xxx.xxx");
            // 您业务中自定义的用户ID,请保持唯一。
            // request.setUserId("xxx");
    
            // 推荐,支持服务路由。
            ContrastSmartVerifyResponse response = contrastSmartVerifyAutoRoute(request);
    
            // 不支持服务自动路由。
            //ContrastSmartVerifyResponse response = contrastSmartVerify("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().getVerifyInfo());
            System.out.println(response.getResultObject() == null ? null
                : response.getResultObject().getRiskInfo());
        }
    
        private static ContrastSmartVerifyResponse contrastSmartVerifyAutoRoute(ContrastSmartVerifyRequest request) {
            // 第一个为主区域Endpoint,第二个为备区域Endpoint。
            List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
                "cloudauth.cn-beijing.aliyuncs.com");
            ContrastSmartVerifyResponse lastResponse = null;
            for (String endpoint : endpoints) {
                try {
                    ContrastSmartVerifyResponse response = contrastSmartVerify(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 ContrastSmartVerifyResponse contrastSmartVerify(String endpoint, ContrastSmartVerifyRequest request)
            throws Exception {
            Config config = new Config();
            config.setAccessKeyId("您的AccessKey ID");
            config.setAccessKeySecret("您的AccessKey Secret");
            config.setEndpoint(endpoint);
            // 设置http代理。
            //config.setHttpProxy("http://127.x.x.x:xxxx");
            // 设置https代理。
            //config.setHttpsProxy("https://127.x.x.x:xxxx");
            com.aliyun.cloudauth20200618.Client client = new com.aliyun.cloudauth20200618.Client(config);
    
            // 创建RuntimeObject实例并设置运行参数。
            RuntimeOptions runtime = new RuntimeOptions();
            runtime.readTimeout = 10000;
            runtime.connectTimeout = 10000;
    
            return client.contrastSmartVerify(request, runtime);
        }
    }
  • 方式二:使用本地图片示例
    import java.io.FileInputStream;
    import java.io.InputStream;
    import java.util.Arrays;
    import java.util.List;
    
    import com.aliyun.cloudauth20200618.models.ContrastSmartVerifyAdvanceRequest;
    import com.aliyun.cloudauth20200618.models.ContrastSmartVerifyResponse;
    import com.aliyun.tea.TeaException;
    import com.aliyun.tea.TeaUnretryableException;
    import com.aliyun.tearpc.models.Config;
    import com.aliyun.teautil.models.RuntimeOptions;
    
    public class ContrastSmartVerify {
    
        public static void main(String[] args) throws Exception {
    
            // 通过以下代码创建API请求并设置参数。
            ContrastSmartVerifyAdvanceRequest request = new ContrastSmartVerifyAdvanceRequest();
            // 请输入场景ID+L。
            request.setSceneId(xxxL);
            request.setOuterOrderNo("xxx");
            // 增强版实人认证的业务场景类型。取值:
            // CERT_SAFE:纯认证模式。
            // CERT_PHOTO_SAFE:认证及照片防翻拍检测模式。
            // MARKET_SAFE:营销安全(包含认证、防翻拍和营销风险识别功能)。
            // FINANCE_SAFE:金融安全(包含认证、防翻拍和金融风险识别功能)。
            // ACCOUNT_SAFE:注册安全(包含认证、防翻拍和注册风险识别功能)。
            request.setMode("CERT_PHOTO_SAFE");
            request.setCertType("IDENTITY_CARD");
            request.setCertName("xxx");
            request.setCertNo("xxx");
            // 当Mode取值为MARKET_SAFE、FINANCE_SAFE或ACCOUNT_SAFE时,Mobile为必填字段。
            request.setMobile("137xxxxxxxx");
            // 用户网络IP。
            // request.setIp("xx.xx.xxx.xxx");
            // 您业务中自定义的用户ID,请保持唯一。
            // request.setUserId("xxx");
    
            InputStream inputStream = null;
            try {
    
                // 本地文件。
                inputStream = new FileInputStream("/xxx.png");
                request.setFacePicFileObject(inputStream);
    
                // 推荐,支持服务路由。
                ContrastSmartVerifyResponse response = contrastSmartVerifyAdvanceAutoRoute(request);
    
                // 不支持服务自动路由。
                //ContrastSmartVerifyResponse response = contrastSmartVerifyAdvance("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().getVerifyInfo());
                System.out.println(response.getResultObject() == null ? null
                    : response.getResultObject().getRiskInfo());
            } finally {
                if(inputStream != null){
                    inputStream.close();
                }
            }
        }
    
        private static ContrastSmartVerifyResponse contrastSmartVerifyAdvanceAutoRoute(ContrastSmartVerifyAdvanceRequest request) {
            // 第一个为主区域Endpoint,第二个为备区域Endpoint。
            List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
                "cloudauth.cn-beijing.aliyuncs.com");
            ContrastSmartVerifyResponse lastResponse = null;
            for (String endpoint : endpoints) {
                try {
                    ContrastSmartVerifyResponse response = contrastSmartVerifyAdvance(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 ContrastSmartVerifyResponse contrastSmartVerifyAdvance(String endpoint, ContrastSmartVerifyAdvanceRequest request)
            throws Exception {
            Config config = new Config();  
            config.setAccessKeyId("您的AccessKey ID");
            config.setAccessKeySecret("您的AccessKey Secret");
            config.setEndpoint(endpoint);
            // 设置http代理。
            //config.setHttpProxy("http://127.x.x.x:xxxx");
            // 设置https代理。
            //config.setHttpsProxy("https://127.x.x.x:xxxx");
            com.aliyun.cloudauth20200618.Client client = new com.aliyun.cloudauth20200618.Client(config);
    
            // 创建RuntimeObject实例并设置运行参数。
            RuntimeOptions runtime = new RuntimeOptions();
            runtime.readTimeout = 10000;
            runtime.connectTimeout = 10000;
    
            return client.contrastSmartVerifyAdvance(request, runtime);
        }
    }