本文介绍了增强版活体验证方案的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>调用示例
InitSmartVerify接口调用示例
import java.util.Arrays;
import java.util.List;
import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.InitSmartVerifyRequest;
import com.aliyun.cloudauth20200618.models.InitSmartVerifyResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
public class InitSmartVerify {
public static void main(String[] args) throws Exception {
// 通过以下代码创建API请求并设置参数。
InitSmartVerifyRequest request = new InitSmartVerifyRequest();
// 请输入场景ID+L。
request.setSceneId(<xxxxL>);
request.setOuterOrderNo("<商户请求的唯一标识>");
// 卡证核身类型，固定值。
request.setMode("LOGIN_SAFE");
// 证件类型，固定值。
request.setCertType("IDENTITY_CARD");
// request.setCertName("<张三>");
// request.setCertNo("<xxx>");
// MetaInfo环境参数，需要通过客户端SDK获取。
request.setMetaInfo(
"{\"apdidToken\":\"\",\"appName\":\"com.aliyun.identity.platform\",\"appVersion\":\"1.0\","
+ "\"bioMetaInfo\":\"5.1.0:11501568,4\",\"deviceModel\":\"JKM-AL00b\",\"deviceType\":\"android\","
+ "\"osVersion\":\"9\",\"zimVer\":\"1.0.0\"}");
request.setMobile("<xxx>");
//request.setIp("<114.xxx.xxx.xxx>");
//request.setUserId("<12345xxxx>");
//request.setCallbackUrl("<https://www.aliyun.com>");
//request.setCallbackToken("<NMjvQanQgplBSaEI0sL86WnQplB>");
// 请在以下四种方式中选择其一。
// 1.人脸图片的Base64编码。
// 2.已授权OSS空间的Bucket名和已授权OSS空间的文件名。
// 3.人脸图片的HTTPS或HTTP地址。
// 4.已通过智能核身得到的CertifyId，认证时的图片作为比对图片。
// 方式一：人脸图片的Base64编码。
// request.setFacePictureBase64("</9j/4AAQSkZJRgABAQAASxxxxxxx>");
// 方式二：已授权OSS空间的Bucket名和已授权OSS空间的文件名。
// request.setOssBucketName("<cn-shanghai-aliyun-cloudauth-xxxxx>");
// request.setOssObjectName("<verify/xxxxx/xxxxxx.jpeg>");
// 方式三：人脸图片的HTTPS或HTTP地址。
request.setFacePictureUrl("<https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg>");
// 方式四：已通过智能核身得到的CertifyId，认证时的图片作为比对图片。
// request.setCertifyId("<0bfa7c493f850e5178b9f8613634c9xx>");
// 推荐，支持服务路由。
InitSmartVerifyResponse response = initSmartVerifyAutoRoute(request);
// 不支持服务自动路由。
//InitSmartVerifyResponse response = initSmartVerify("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().getCertifyId());
}
private static InitSmartVerifyResponse initSmartVerifyAutoRoute(InitSmartVerifyRequest request) {
// 第一个为主区域Endpoint，第二个为备区域Endpoint。
List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com");
InitSmartVerifyResponse lastResponse = null;
for (String endpoint : endpoints) {
try {
InitSmartVerifyResponse response = initSmartVerify(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 InitSmartVerifyResponse initSmartVerify(String endpoint, InitSmartVerifyRequest 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://xxx.xx.xx.xx:xxxx>");
// 设置HTTPS代理。
//config.setHttpsProxy("<https://xxx.xx.xx.xx:xxxx>");
Client client = new Client(config);
// 创建RuntimeObject实例并设置运行参数。
RuntimeOptions runtime = new RuntimeOptions();
runtime.readTimeout = 10000;
runtime.connectTimeout = 10000;
return client.initSmartVerify(request, runtime);
}
}DescribeSmartVerify接口调用示例
import java.util.Arrays;
import java.util.List;
import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.DescribeSmartVerifyRequest;
import com.aliyun.cloudauth20200618.models.DescribeSmartVerifyResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
public class DescribeSmartVerify {
public static void main(String[] args) throws Exception {
// 通过以下代码创建API请求并设置参数。
DescribeSmartVerifyRequest request = new DescribeSmartVerifyRequest();
// 请输入场景ID+L。
request.setSceneId(<xxxxL>);
request.setCertifyId("<91707dc296d469ad38e4c5efa6a0xxxx>");
// 推荐，支持服务路由。
//DescribeSmartVerifyResponse response = describeSmartVerifyAutoRoute(request);
// 不支持服务自动路由。
DescribeSmartVerifyResponse response = describeSmartVerify("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().getMaterialInfo());
}
private static DescribeSmartVerifyResponse describeSmartVerifyAutoRoute(DescribeSmartVerifyRequest request) {
// 第一个为主区域Endpoint，第二个为备区域Endpoint。
List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com");
DescribeSmartVerifyResponse lastResponse = null;
for (String endpoint : endpoints) {
try {
DescribeSmartVerifyResponse response = describeSmartVerify(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 DescribeSmartVerifyResponse describeSmartVerify(String endpoint, DescribeSmartVerifyRequest 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("<https://xx.xx.xx.xx:xxxx>");
Client client = new Client(config);
// 创建RuntimeObject实例并设置运行参数。
RuntimeOptions runtime = new RuntimeOptions();
runtime.readTimeout = 10000;
runtime.connectTimeout = 10000;
return client.describeSmartVerify(request, runtime);
}
}