本文为您介绍Python调用短信查询API的操作流程。
短信发送记录查询接口(QuerySendDetails)
注意 使用短信服务新版SDK调用API接口,请查看新版SDK参考和API参考。
入参列表
参数名称 | 参数类型 | 必填与否 | 样例取值 | 参数说明 |
---|---|---|---|---|
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 | 发送总条数。 |
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 | 外部流水扩展字段。 |
技术对接步骤
- python版本要求:python 2.6+, python3.x
-
SDK下载:下载地址
-
执行:
- 安装依赖:进入根目录执行命令: python setup.py install #如果为python3,请执行:python3 setup.py install
- 修改信息:从sms控制台上获取ACCESS_KEY_ID与ACCESS_KEY_SECRET,并填入文件const.py中
- 运行程序:python demo_sms_query.py #如果为python3,请执行python3 demo_sms_query.py
注意 您还需要在控制台上申请短信模板,并将相关信息填入至文件demo_sms_query.py中。
在文档使用中是否遇到以下问题
更多建议
匿名提交