本文为您介绍Java调用短信查询API的操作流程。
短信发送记录查询接口(QuerySendDetails)
用于查询短信发送的状态,是否成功到达终端用户手机
入参列表
参数名称 | 参数类型 | 必填与否 | 样例取值 | 参数说明 |
PhoneNumber | String | 必须 | 1390000**** | 短信接收号码,如果需要查询国际短信,号码前需要带上对应国家的区号,区号的获取详见国际短信支持国家信息查询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 | 发送总条数。 |
smsSendDetailDTOs | Object | - | 发送明细结构体,详见Demo样例。 |
Demo样例
出参名称 | 出参类型 | 样例取值 | 参数说明 |
phoneNum | String | 1390000**** | 手机号码。 |
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 | 外部流水扩展字段。 |
下载SDK工具包
SDK工具包中一共包含了2个类库,一个aliyun-java-sdk-core包,另外一个是alicom-dysms-api包,将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包,添加到工程类库中依赖使用。
SDK&DEMO[下载地址]
代码示例
具体代码示例,请参见QuerySendDetails接口文档。
- 本页导读 (1)