产品解决方案文档与社区权益中心定价云市场合作伙伴支持与服务了解阿里云
备案控制台登录/注册
首页 实人认证 金融级实人认证 开发参考 金融级实人认证方案 纯服务端（API）接入 Java SDK调用示例

Java SDK调用示例

更新时间: 2023-09-04 13:40:04

本文介绍了金融级实人认证纯服务端API的Java SDK调用示例。

SDK使用说明

如果需要其他语言的SDK示例代码，您可以通过OpenAPI 开发者门户在线调试工具调试API接口，该工具会自动生成相应API的SDK调用示例代码。您可以单击以下接口链接进行调试：

调试ContrastFaceVerify接口

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

前提条件

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

使用Maven引入SDK

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

照片实人认证调用示例

import com.aliyun.cloudauth20190307.Client;
import com.aliyun.cloudauth20190307.models.ContrastFaceVerifyRequest;
import com.aliyun.cloudauth20190307.models.ContrastFaceVerifyResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

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

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

        // 通过以下代码创建API请求并设置参数。
        ContrastFaceVerifyRequest request = new ContrastFaceVerifyRequest();

        // 固定值。
        request.setProductCode("ID_MIN");
        // 固定值。
        request.setCertType("IDENTITY_CARD");
        request.setCertName("姓名张先生");
        request.setIp("用户IP地址");
        request.setMobile("用户手机号");
        request.setDeviceToken("通过设备指纹获取的deviceToken");
        request.setUserId("用户ID");
        request.setCertNo("18位身份证号");
        request.setOuterOrderNo("商户请求的唯一标识");
        // 请输入场景+L。
        request.setSceneId(0L);
        request.setModel("FRONT_CAMERA_LIVENESS");

        // 请在以下四种方式中选择其一。
        // 1.照片Base64编码。
        // 2.照片OSS bucket名和文件名。
        // 3.照片OSS的URL地址。
        // 4.已经实人认证通过的CertifyId。

        // 方式一：照片Base64。
        request.setFaceContrastPicture("人脸照片Base64编码");
        // 方式二：照片OSS bucket名和文件名。
        //request.setOssBucketName("cn-shanghai-aliyun-cloudauth-xxxxx");
        //request.setOssObjectName("verify/xxxxx/xxxxxx.jpeg");
        // 方式三：照片OSS的URL地址，公网可访问。
        //request.setFaceContrastPictureUrl("https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg")
        // 方式四：已经实人认证通过的CertifyId。
        //request.setCertifyId("0bfa7c493f850e5178b9f8613634c9xx");

        // 如需开启个人信息加密传输。
        // request.setEncryptType("SM2");
        // request.setCertName("BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==");
        // request.setCertNo("BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg==");

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

        // 不支持服务自动路由。
        //ContrastFaceVerifyResponse response = contrastFaceVerify("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().getIdentityInfo());
        System.out.println(response.getBody().getResultObject() == null ? null
                : response.getBody().getResultObject().getMaterialInfo());
    }

    private static ContrastFaceVerifyResponse contrastFaceVerifyAutoRoute(ContrastFaceVerifyRequest request) {
        // 第一个为主区域Endpoint，第二个为备区域Endpoint。
        List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com", "cloudauth.cn-beijing.aliyuncs.com");
        ContrastFaceVerifyResponse lastResponse = null;
        for (int i=0; i<endpoints.size(); i++) {
            try {
                ContrastFaceVerifyResponse response = contrastFaceVerify(endpoints.get(i), request);
                lastResponse = response;

                // 服务端错误，切换到下个区域调用。
                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 ContrastFaceVerifyResponse contrastFaceVerify(String endpoint, ContrastFaceVerifyRequest 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://xx.xx.xx.xx:xxxx");
        // 设置https代理。
        //config.setHttpsProxy("http://xx.xx.xx.xx:xxxx");
        Client client = new Client(config);

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

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

视频实人认证调用示例

支持OSS对象存储方式和本地文件两种方式。

使用本地文件的方式（推荐）

import com.aliyun.cloudauth20190307.Client;
import com.aliyun.cloudauth20190307.models.ContrastFaceVerifyAdvanceRequest;
import com.aliyun.cloudauth20190307.models.ContrastFaceVerifyResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

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

public class ContrastFaceVerifyWithVideoFile {

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

        // 通过以下代码创建API请求并设置参数。
        ContrastFaceVerifyAdvanceRequest request = new ContrastFaceVerifyAdvanceRequest();

        // 请输入场景ID+L。
        request.setSceneId(1L);

        request.setOuterOrderNo("商户请求的唯一标识");
        request.setProductCode("ID_MIN_VIDEO");
        // 卡证核身类型，固定值。
        request.setModel("FRONT_CAMERA_LIVENESS");
        // 证件类型，固定值。
        request.setCertType("IDENTITY_CARD");
        request.setCertName("张先生");
        request.setCertNo("xxxx");
        //request.setDeviceToken("xxxx");
        //request.setMobile("130xxxxxxxx");
        //request.setIp("114.xxx.xxx.xxx");
        //request.setUserId("12345xxxx");
        // 如需开启个人信息加密传输。
        // request.setEncryptType("SM2");
        // request.setCertName("BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==");
        // request.setCertNo("BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg==");

        InputStream inputStream = null;
        try {
            // 设置本地文件路径。
            inputStream = new FileInputStream("test.mp4");
            request.setFaceContrastFileObject(inputStream);

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

            // 不支持服务自动路由。
            //ContrastFaceVerifyResponse response = contrastFaceVerify("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().getIdentityInfo());
            System.out.println(response.getBody().getResultObject() == null ? null
                    : response.getBody().getResultObject().getMaterialInfo());
        } finally {
            if(inputStream != null){
                inputStream.close();
            }
        }
    }

    private static ContrastFaceVerifyResponse contrastFaceVerifyAutoRoute(ContrastFaceVerifyAdvanceRequest request) {
        // 第一个为主区域Endpoint，第二个为备区域Endpoint。
        List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com", "cloudauth.cn-beijing.aliyuncs.com");
        ContrastFaceVerifyResponse lastResponse = null;
        for (int i=0; i<endpoints.size(); i++) {
            try {
                ContrastFaceVerifyResponse response = contrastFaceVerify(endpoints.get(i), request);
                lastResponse = response;

                // 服务端错误，切换到下个区域调用。
                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 ContrastFaceVerifyResponse contrastFaceVerify(String endpoint, ContrastFaceVerifyAdvanceRequest 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://xx.xx.xx.xx:xxxx");
        // 设置https代理。
        //config.setHttpsProxy("http://xx.xx.xx.xx:xxxx");
        Client client = new Client(config);

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

        return client.contrastFaceVerifyAdvance(request, runtime);
    }

}

使用OSS对象存储的方式

import com.aliyun.cloudauth20190307.Client;
import com.aliyun.cloudauth20190307.models.ContrastFaceVerifyRequest;
import com.aliyun.cloudauth20190307.models.ContrastFaceVerifyResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

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

public class ContrastFaceVerifyWithVideoOSS {

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

        // 通过以下代码创建API请求并设置参数。
        ContrastFaceVerifyRequest request = new ContrastFaceVerifyRequest();

        // 请输入场景ID+L。
        request.setSceneId(0L);

        request.setOuterOrderNo("商户请求的唯一标识");
        request.setProductCode("ID_MIN_VIDEO");
        // 卡证核身类型，固定值。
        request.setModel("FRONT_CAMERA_LIVENESS");
        // 证件类型，固定值。
        request.setCertType("IDENTITY_CARD");
        request.setCertName("张先生");
        request.setCertNo("xxxx");
        //request.setDeviceToken("xxxx");
        //request.setMobile("130xxxxxxxx");
        //request.setIp("114.xxx.xxx.xxx");
        //request.setUserId("12345xxxx");
        request.setOssBucketName("xxxxx");
        request.setOssObjectName("xxxxx");
        // 如需开启个人信息加密传输。
        // request.setEncryptType("SM2");
        // request.setCertName("BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==");
        // request.setCertNo("BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg==");

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

        // 不支持服务自动路由。
        //ContrastFaceVerifyResponse response = contrastFaceVerify("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().getIdentityInfo());
        System.out.println(response.getBody().getResultObject() == null ? null
                : response.getBody().getResultObject().getMaterialInfo());
    }

    private static ContrastFaceVerifyResponse contrastFaceVerifyAutoRoute(ContrastFaceVerifyRequest request) {
        // 第一个为主区域Endpoint，第二个为备区域Endpoint。
        List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com", "cloudauth.cn-beijing.aliyuncs.com");
        ContrastFaceVerifyResponse lastResponse = null;
        for (int i=0; i<endpoints.size(); i++) {
            try {
                ContrastFaceVerifyResponse response = contrastFaceVerify(endpoints.get(i), request);
                lastResponse = response;

                // 服务端错误，切换到下个区域调用。
                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 ContrastFaceVerifyResponse contrastFaceVerify(String endpoint, ContrastFaceVerifyRequest 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://xx.xx.xx.xx:xxxx");
        // 设置https代理。
        //config.setHttpsProxy("http://xx.xx.xx.xx:xxxx");
        Client client = new Client(config);

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

        return client.contrastFaceVerifyWithOptions(request, runtime);
    }

}

阿里云首页 实人认证 相关技术圈
为什么选择阿里云什么是云计算全球基础设施技术领先稳定可靠安全合规分析师报告
产品和定价全部产品免费试用产品动态产品定价价格计算器云上成本管理
解决方案技术解决方案行业解决方案
文档与社区文档开发者社区天池大赛培训与认证
权益中心免费试用高校计划企业扶持计划推荐返现计划
支持与服务基础服务企业增值服务迁云服务官网公告系统状态信任中心
关注阿里云
关注阿里云公众号或下载阿里云APP，关注云资讯，随时随地运维管控云服务
阿里云APP阿里云微信
售前咨询：95187-1
售后服务：400-80-13260
法律声明及隐私权政策Cookies政策廉正举报安全举报联系我们加入我们
阿里巴巴集团淘宝网天猫全球速卖通阿里巴巴国际交易市场1688阿里妈妈飞猪阿里云计算AliOS万网高德UC友盟优酷钉钉支付宝达摩院淘宝海外阿里云盘饿了么
© 2009-2023 Aliyun.com 版权所有 增值电信业务经营许可证： 浙B2-20080101 域名注册服务机构许可： 浙D3-20210002 京D3-20220015
浙公网安备 33010602009975号浙B2-20080101-4
关注我们：
新浪微博
联系我们
© 2009-2023 Aliyun.com 版权所有<br/>增值电信业务经营许可证： <a href="http://beian.miit.gov.cn/" target="_blank">浙B2-20080101</a> <br/>域名注册服务机构许可： <a href="https://domain.miit.gov.cn/域名注册服务机构/互联网域名/阿里云计算有限公司 " target="_blank">浙D3-20210002</a> <a href="https://domain.miit.gov.cn/域名注册服务机构/互联网域名/阿里巴巴云计算北京有限公司 " target="_blank">京D3-20220015</a>