Java SDK调用示例
本文介绍了金融级实人认证纯服务端API的Java SDK调用示例。
SDK使用说明
如果需要其他语言的SDK示例代码,您可以通过OpenAPI 开发者门户在线调试工具调试API接口,该工具会自动生成相应API的SDK调用示例代码。您可以单击以下接口链接进行调试:
本章节提供的是最新版本的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);
}
}