文档中心 短信 API 文档 短信API 拉取单个手机短信状态

拉取单个手机短信状态

最近更新时间:2019-04-29 18:22:04

接口描述

功能描述

拉取单个手机的短信状态(下发状态,短信回复等)。

URL 示例

POST https://yun.tim.qq.com/v5/tlssmssvr/pullstatus4mobile?sdkappid=xxxxx&random=xxxx
:sdkappid 请填写您在腾讯云上申请到的,random 请填成随机数。

请求参数

{
    "begin_time": 1464624000,
    "end_time": 1464706800,
    "max": 10,
    "mobile": "13788888888",
    "nationcode": "86",
    "sig": "c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df",
    "time": 1457336869,
    "type": 1
}
参数 必选 类型 描述
begin_time number 拉取起始时间,UNIX 时间戳(时间:秒)
end_time number 拉取的截止时间,UNIX 时间戳(时间:秒)
max number 拉取最大条数,最多 100
mobile string 手机号码
nationcode string 国家码
sig string App 凭证,具体计算方式见下注
time number 请求发起时间,UNIX 时间戳(单位:秒),如果和系统时间相差超过 10 分钟则会返回失败
type number 拉取类型,Enum{0: 短信下发状态, 1: 短信回复}


"sig" 字段根据公式 sha256(appkey=$appkey&random=$random&time=$time)生成,其伪代码如下:

string strAppkey = "5f03a35d00ee52a21327ab048186a2c4"; //sdkappid 对应的 appkey,需要业务方高度保密
string strRand = "7226249334"; //URL 中的 random 字段的值
string strTime = "1457336869"; //UNIX 时间戳
string sig = sha256(appkey=5f03a35d00ee52a21327ab048186a2c4&random=7226249334&time=1457336869)
           = c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df;

响应参数

{
    "result": 0,
    "errmsg": "ok",
    "count": 3,
    "data": []
}
参数 必选 类型 描述
result number 错误码,0表示成功(计费依据),非0表示失败
errmsg string 错误消息,result 非0时的具体错误信息
count number 返回的信息条数,result 为 0 时有效
data array 具体内容见 短信下发状态通知短信回复

DEMO

腾讯云短信服务为您提供了 Java SDKPHP SDKPython SDKNode.js SDKC# SDK 供您参考,欢迎查阅。