短信发送记录查询接口(QuerySendDetails)
入参列表
参数名称 | 参数类型 | 必填与否 | 样例取值 | 参数说明 |
PhoneNumber | String | 必须 | 15000000000 | 短信接收号码 |
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样例 |
出参名称 | 出参类型 | 样例取值 | 参数说明 |
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 | 外部流水扩展字段 |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
根据您的描述,您想了解如何使用阿里云的短信服务(SMS)查询发送记录的接口及其参数、出参详情以及技术对接步骤。下面我将为您提供详细的说明和指导:
String
): 必填。表示短信接收号码,例如:15000000000
。String
): 可选。发送流水号,从调用发送接口返回值中获取,例如:1234^1234
。String
): 必填。短信发送日期,格式为yyyyMMdd
,支持最近30天记录查询,例如:20170525
。Number
): 必填。页大小,最大值为50,例如:10
。Number
): 必填。当前页码,例如:1
。String
): 请求ID,如:8906582E-6722
。String
): 状态码,返回OK
代表请求成功,其他错误码需参考错误码列表。String
): 对状态码的描述信息。Number
): 发送总条数,例如:100
。Number
): 总页数,例如:10
。Object
): 发送明细结构体数组,包含每条短信的详细信息。String
): 手机号码,例如:13000000000
。Number
): 发送状态,1:等待回执,2:发送失败,3:发送成功,例如:1
。String
): 运营商短信错误码。String
): 模板ID,例如:SMS_000
。String
): 短信内容,例如:【阿里云】你好!短信内容。Object
/时间对象): 发送时间,例如:2017-05-25 00:00:00
。String
): 接收时间,例如:2017-05-25 00:00:00
。String
): 外部流水扩展字段,例如:123
。下载SDK工具包: 首先,您需要访问阿里云官方文档或SDK下载页面,找到适用于您开发语言的SDK(以PHP为例),通常包括aliyun-php-sdk-core
基础库和特定服务的库,如alicom-dysms-api
。将这些类库添加到您的项目依赖中。
配置SDK: 在您的代码中引入必要的命名空间,并配置阿里云AccessKey ID、AccessKey Secret等认证信息,这是与阿里云服务交互的基础。
编写查询代码: 使用SDK提供的方法构造查询请求,传入上述提到的入参,如PhoneNumber、SendDate等,然后调用QuerySendDetails
方法发起请求。
处理响应: 根据返回的出参进行逻辑处理,比如展示发送记录、分析发送状态等。
异常处理: 不要忘记对可能发生的网络错误、API调用错误等进行捕获和处理,确保程序的健壮性。
具体代码示例和更详细的说明可以参考阿里云官方文档中关于短信服务SDK的使用指南,那里会有完整的示例代码和配置说明,帮助您快速完成技术对接。