拉取单个手机短信状态-短信-文档中心-腾讯云

接口描述

功能描述

拉取单个手机的短信状态（下发状态，短信回复等）。

URL 示例

POST https://yun.tim.qq.com/v5/tlssmssvr/pullstatus4mobile?sdkappid=xxxxx&random=xxxx

其中，sdkappid请填写您在短信控制台添加应用后生成的实际 SDK AppID，random请填写成随机数。

请求参数

请求参数如下表所示。

参数	必选	类型	描述
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;

请求示例：

{
    "begin_time": 1464624000,
    "end_time": 1464706800,
    "max": 10,
    "mobile": "13788888888",
    "nationcode": "86",
    "sig": "c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df",
    "time": 1457336869,
    "type": 1
}

响应参数

响应参数如下表所示。

参数	必选	类型	描述
result	是	number	错误码，0表示成功（计费依据），非0表示失败
errmsg	是	string	错误消息，result 非0时的具体错误信息
count	否	number	返回的信息条数，result 为 0 时有效
data	否	array	具体内容请参见短信下发状态通知和短信回复

响应示例：

{
    "result": 0,
    "errmsg": "ok",
    "count": 3,
    "data": []
}

DEMO

腾讯云短信服务为您提供了 Java SDK、PHP SDK、Python SDK、Node.js SDK 和 C# SDK 供您参考，欢迎查阅。