短信查询API(QuerySendDetails)---JAVA

短信发送记录查询接口(QuerySendDetails)


用于查询短信发送的状态，是否成功到达终端用户手机

入参列表

参数名称	参数类型	必填与否	样例取值	参数说明
PhoneNumber	String	必须	15000000000	短信接收号码,如果需要查询国际短信,号码前需要带上对应国家的区号,区号的获取详见国际短信支持国家信息查询API接口
BizId	String	可选	1234^1234	发送流水号,从调用发送接口返回值中获取
SendDate	String	必须	20170525	短信发送日期格式yyyyMMdd,支持最近30天记录查询
PageSize	Number	必须	10	页大小Max=50
CurrentPage	Number	必须	1	当前页码

出参列表

出参名称	出参类型	样例取值	参数说明
RequestId	String	8906582E-6722	请求ID
Code	String	OK	状态码-返回OK代表请求成功,其他错误码详见错误码列表
Message	String	请求成功	状态码的描述
TotalCount	Number	100	发送总条数
TotalPage	Number	10	总页数
smsSendDetailDTOs	Object	-	发送明细结构体,详见Demo样例

Demo样例

出参名称	出参类型	样例取值	参数说明
phoneNum	String	13000000000	手机号码
sendStatus	Number	1	发送状态 1：等待回执，2：发送失败，3：发送成功
errCode	String	DELIVERED	运营商短信错误码
templateCode	String	SMS_000	模板ID
content	String	【阿里云】你好！	短信内容
sendDate	Object	2017-05-25 00:00:00	发送时间
receiveDate	String	2017-05-25 00:00:00	接收时间
outId	String	123	外部流水扩展字段

技术对接步骤



1:下载SDK工具包


SDK工具包中一共包含了2个类库，一个aliyun-java-sdk-core包，另外一个是alicom-dysms-api包，将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包，添加到工程类库中依赖使用。
SDK&DEMO[ 下载地址]

2: 编写样例程序


```java //设置超时时间 System.setProperty(“sun.net.client.defaultConnectTimeout”, “10000”); System.setProperty(“sun.net.client.defaultReadTimeout”, “10000”);<pre style='background: rgb(246, 246, 246); font: 12px/1.6 "YaHei Consolas Hybrid", Consolas, "Meiryo UI", "Malgun Gothic", "Segoe UI", "Trebuchet MS", Helvetica, monospace, monospace; padding: 10px; outline: 0px; border-radius: 3px; border: 1px solid rgb(221, 221, 221); color: rgb(51, 51, 51); text-transform: none; text-indent: 0px; letter-spacing: normal; overflow: auto; margin-top: 0px; margin-right: 0px; margin-bottom: 0px !important; margin-left: 0px; word-spacing: 0px; white-space: pre-wrap; word-wrap: break-word; box-sizing: border-box; orphans: 2; widows: 2; font-size-adjust: none; font-stretch: normal; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;' prettyprinted?="" linenums="">

1.     //云通信产品-短信API服务产品名称（短信产品名固定，无需修改）
2.     final String product = "Dysmsapi";
3.     //云通信产品-短信API服务产品域名（接口地址固定，无需修改）
5.     final String domain = "dysmsapi.aliyuncs.com";
7.     //此处需要替换成开发者自己的AK信息
8.     final String accessKeyId = "yourAccessKeyId";
9.     final String accessKeySecret = "yourAccessKeySecret";
11.     //初始化ascClient
12.     IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
13.     DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
14.     IAcsClient acsClient = new DefaultAcsClient(profile);
16.     //组装请求对象
17.     QuerySendDetailsRequest request = new QuerySendDetailsRequest();
18.     //必填-号码
19.     request.setPhoneNumber("150000000");
20.     //可选-调用发送短信接口时返回的BizId
21.     request.setBizId("1234567^8901234");
22.     //必填-短信发送的日期 支持30天内记录查询（可查其中一天的发送数据），格式yyyyMMdd
23.     request.setSendDate("20170543");
24.     //必填-页大小
25.     request.setPageSize(10L);
26.     //必填-当前页码从1开始计数
27.     request.setCurrentPage(1L);
29.     //hint 此处可能会抛出异常，注意catch
30.     QuerySendDetailsResponse querySendDetailsResponse = acsClient.getAcsResponse(request);
32.     //获取返回结果
33.    if(querySendDetailsResponse.getCode() != null && querySendDetailsResponse.getCode().equals("OK")){
34.     //代表请求成功
35.   }