本文介绍了智能反诈发送闪信和查询发送闪信明细的Java SDK调用示例。

SDK使用说明

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

前提条件

使用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 {
        Config config = new Config();
        config.setAccessKeyId("您的AccessKey ID");
        config.setAccessKeySecret("您的AccessKey Secret");
        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 {
        Config config = new Config();
        config.setAccessKeyId("您的AccessKey ID");
        config.setAccessKeySecret("您的AccessKey Secret");
        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);
    }
}