卡证核身方案银行卡二三四要素认证的JavaSDK如何调用-阿里云帮助中心

本文介绍了卡证核身方案银行卡二三四要素认证的Java SDK调用示例。

SDK使用说明

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

前提条件

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

使用Maven引入SDK

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

示例

方式一：使用证件图片的URL认证示例

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

import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.VerifyBankElementRequest;
import com.aliyun.cloudauth20200618.models.VerifyBankElementResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

public class VerifyBankElementTest {

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

        // 通过以下代码创建API请求并设置参数。
        VerifyBankElementRequest request = new VerifyBankElementRequest();
        // 场景ID。
        request.setSceneId(xxxxL);
        request.setOuterOrderNo(商户请求的唯一标识);
        request.setMode(OCR_VERIFY_BANK_CARD);
        request.setIdName(张三);
        request.setIdNo(18位身份证号);
        request.setMobile(手机号);
        //request.setBankCardNo(银行卡号);
        request.setBankCardUrl(银行卡证件http、https地址);

        // 推荐，支持服务路由。
        VerifyBankElementResponse response = bankElementSmartVerifyAutoRoute(request);

        // 不支持服务自动路由。
        //BankElementSmartVerifyResponse response = bankElementSmartVerify(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().getPassed());
        System.out.println(response.getResultObject().getSubCode());
        System.out.println(response.getResultObject().getCertifyId());
        System.out.println(response.getResultObject().getMaterialInfo());
    }

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

                // 服务端错误，切换到下个区域调用。
                if (response != null && "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 VerifyBankElementResponse bankElementSmartVerify(String endpoint, VerifyBankElementRequest 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);
        // 设置您的Endpoint。
        config.setEndpoint(endpoint);
        // 设置https代理。
        //config.setHttpsProxy(https://xx.xx.xx.xx:xxxx);
        // 设置http代理。
        //config.setHttpProxy(http://xx.xx.xx.xx:xxxx);
        Client client = new Client(config);

        // 创建RuntimeObject实例并设置运行参数。
        RuntimeOptions runtime = new RuntimeOptions();
        // 设置调用超时时间（单位ms）。
        runtime.readTimeout = 10000;
        // 设置连接超时时间（单位ms）。
        runtime.connectTimeout = 10000;
        // 设置是否自动重试。
        runtime.autoretry = false;

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

方式二：使用本地证件文件路径认证示例

import java.io.FileInputStream;
import java.io.InputStream;
import java.util.Arrays;
import java.util.List;

import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.VerifyBankElementAdvanceRequest;
import com.aliyun.cloudauth20200618.models.VerifyBankElementResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

public class BankElementSmartVerifyDemo2 {

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

        // 通过以下代码创建API请求并设置参数。
        VerifyBankElementAdvanceRequest request = new VerifyBankElementAdvanceRequest();
        // 场景ID。
        request.setSceneId(xxxxL);
        request.setOuterOrderNo(商户请求的唯一标识);
        request.setMode(OCR_VERIFY_BANK_CARD);
        request.setIdName(张三);
        request.setIdNo(18位身份证号);
        request.setMobile(手机号);
        //request.setBankCardNo(银行卡号);

        InputStream inputStream = new FileInputStream(银行卡本地文件路径);
        request.setBankCardFileObject(inputStream);

        // 推荐，支持服务路由。
        VerifyBankElementResponse response = bankElementSmartVerifyAutoRoute(request);

        // 不支持服务自动路由。
        // BankElementSmartVerifyResponse response = bankElementSmartVerify(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().getPassed());
        System.out.println(response.getResultObject().getSubCode());
        System.out.println(response.getResultObject().getCertifyId());
        System.out.println(response.getResultObject().getMaterialInfo());

        // 通过以下代码关闭资源。
        inputStream.close();
    }

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

                // 服务端错误，切换到下个区域调用。
                if (response != null && "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 VerifyBankElementResponse bankElementSmartVerify(String endpoint, VerifyBankElementAdvanceRequest 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);
        // 设置您的Endpoint。
        config.setEndpoint(endpoint);
        // 设置https代理。
        //config.setHttpsProxy(https://xx.xx.xx.xx:xxxx);
        // 设置http代理。
        //config.setHttpProxy(http://xx.xx.xx.xx:xxxx);
        Client client = new Client(config);

        // 创建RuntimeObject实例并设置运行参数。
        RuntimeOptions runtime = new RuntimeOptions();
        // 设置调用超时时间（单位ms）。
        runtime.readTimeout = 10000;
        // 设置连接超时时间（单位ms）。
        runtime.connectTimeout = 10000;
        // 设置是否自动重试。
        runtime.autoretry = false;

        return client.verifyBankElementAdvance(request, runtime);
    }