本文为您介绍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中。