如何使用JavaSDK集成纯服务端认证方案_实人认证(ID Verification)-阿里云帮助中心

本文介绍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 {
        // 阿里云账号AccessKey拥有所有API的访问权限，建议您使用RAM用户进行API访问或日常运维。
        // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里，否则可能导致AccessKey泄露，威胁您账号下所有资源的安全。
        // 本示例通过阿里云Credentials工具从环境变量中读取AccessKey，来实现API访问的身份验证。如何配置环境变量，请参见https://help.aliyun.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);
        // 设置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 {
        // 阿里云账号AccessKey拥有所有API的访问权限，建议您使用RAM用户进行API访问或日常运维。
        // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里，否则可能导致AccessKey泄露，威胁您账号下所有资源的安全。
        // 本示例通过阿里云Credentials工具从环境变量中读取AccessKey，来实现API访问的身份验证。如何配置环境变量，请参见https://help.aliyun.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);
        // 设置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);
    }
}