本文介绍了智能反诈发送闪信和查询发送闪信明细的Java SDK调用示例。
SDK使用说明
如果需要其他语言的SDK示例代码,您可以通过OpenAPI开发者门户在线调试工具调试API接口。该工具会自动生成相应API的SDK调用示例代码,详细信息,请参见:
前提条件
需要使用的Java版本在1.8版本及以上。
使用Maven引入SDK
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>cloudauth20200618</artifactId>
<version>1.0.6</version>
</dependency>
调用示例
SendSms接口调用示例
import java.util.Arrays;
import java.util.List;
import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.SendSmsRequest;
import com.aliyun.cloudauth20200618.models.SendSmsResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
public class SendSms {
public static void main(String[] args) throws Exception {
// 通过以下代码创建API请求并设置参数。
SendSmsRequest request = new SendSmsRequest();
// 11位国内手机号,您也可以在手机号前面增加“86”字符,表示中国内地。单次请求最多支持1000个手机号码,多个号码之间使用英文逗号分隔。
request.setMobile("861386609xxxx,1572495xxxx");
// 文档提供的签名。关于签名的信息,请联系运营人员。
request.setSignName("xxx");
// 文档提供的模板。
request.setTemplateCode("SMS_21535xxx");
// 客户服务端自定义的业务唯一标识,用于后续定位排查问题。支持最长为32位长度的字母数字组合,请确保唯一。
//request.setOuterOrderNo();
// 推荐,支持服务路由。
SendSmsResponse response = sendSms(request);
// 不支持服务自动路由。
//SendSmsResponse response = sendSms("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().getBizId());
}
private static SendSmsResponse sendSms(SendSmsRequest request) {
// 第一个为主区域Endpoint,第二个为备区域Endpoint。
List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com");
SendSmsResponse lastResponse = null;
for (String endpoint : endpoints) {
try {
SendSmsResponse response = sendSms(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 SendSmsResponse sendSms(String endpoint, SendSmsRequest 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.0.0.1:8088");
// 设置https代理。
//config.setHttpsProxy("http://127.0.0.1:8088");
Client client = new Client(config);
// 创建RuntimeObject实例并设置运行参数。
RuntimeOptions runtime = new RuntimeOptions();
// 设置调用超时时间(单位ms)。
runtime.readTimeout = 10000;
// 设置连接超时时间(单位ms)。
runtime.connectTimeout = 10000;
return client.sendSms(request, runtime);
}
}
DescribeSmsDetail接口调用示例
import java.util.Arrays;
import java.util.List;
import com.aliyun.cloudauth20200618.Client;
import com.aliyun.cloudauth20200618.models.DescribeSmsDetailRequest;
import com.aliyun.cloudauth20200618.models.DescribeSmsDetailResponse;
import com.aliyun.cloudauth20200618.models.DescribeSmsDetailResponse.DescribeSmsDetailResponseItems;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.tearpc.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
public class DescribeSmsDetail {
public static void main(String[] args) throws Exception {
// 通过以下代码创建API请求并设置参数。
DescribeSmsDetailRequest request = new DescribeSmsDetailRequest();
// 八位年月日组成的字符串,支持查询最近30天记录查询。
request.setSendDate("20210429");
// 每页显示的明细数,最多支持100条明细信息。
request.setPageSize(10);
// 当前页码。
request.setCurrentPage(1);
// 发送闪信接口返回的唯一发送回执ID。
//request.setBizId("");
// 接收闪信的11位手机号码。
//request.setMobile("138xxxxxxxx");
// 文档提供的签名。关于签名的信息,请联系运营人员。
//request.setSignName("xxx");
// 文档提供的模板ID。
//request.setTemplateCode("SMS_21535xxx");
// 客户服务端自定义的业务唯一标识。
//request.setOuterOrderNo("xxx");
// 查询明细发送状态。FAILED表示查询发送失败明细,SUCCESS表示查询发送成功明细,RECEIPT表示查询未回执明细,不填则查询全部明细。
//request.setSendStatus("SUCCESS");
// 明细错误码。
//request.setErrorCode("xxx");
// 推荐,支持服务路由。
DescribeSmsDetailResponse response = describeSmsDetailRequest(request);
// 不支持服务自动路由。
//DescribeSmsDetailResponse response = describeSmsDetailRequest("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.getTotalItem());
System.out.println(response.getTotalPage());
List<DescribeSmsDetailResponse.DescribeSmsDetailResponseItems> items = response.getItems();
if(items != null && items.size() > 0){
for (DescribeSmsDetailResponseItems item : items) {
System.out.println(item.bizId);
System.out.println(item.mobile);
System.out.println(item.templateCode);
System.out.println(item.signName);
System.out.println(item.outerOrderNo);
System.out.println(item.taskDate);
System.out.println(item.content);
System.out.println(item.sendStatus);
System.out.println(item.smsSize);
System.out.println(item.sendDate);
System.out.println(item.receiveDate);
System.out.println(item.errorCode);
System.out.println(item.errorMessage);
System.out.println();
}
}
}
private static DescribeSmsDetailResponse describeSmsDetailRequest(DescribeSmsDetailRequest request) {
// 第一个为主区域Endpoint,第二个为备区域Endpoint。
List<String> endpoints = Arrays.asList("cloudauth.cn-shanghai.aliyuncs.com",
"cloudauth.cn-beijing.aliyuncs.com");
DescribeSmsDetailResponse lastResponse = null;
for (String endpoint : endpoints) {
try {
DescribeSmsDetailResponse response = describeSmsDetailRequest(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 DescribeSmsDetailResponse describeSmsDetailRequest(String endpoint, DescribeSmsDetailRequest 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.x.x.x:8088");
// 设置https代理。
//config.setHttpsProxy("http://xxx.x.x.x:8088");
Client client = new Client(config);
// 创建RuntimeObject实例并设置运行参数。
RuntimeOptions runtime = new RuntimeOptions();
// 设置调用超时时间(单位ms)。
runtime.readTimeout = 10000;
// 设置连接超时时间(单位ms)。
runtime.connectTimeout = 10000;
return client.describeSmsDetail(request, runtime);
}
}