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