接口描述
功能描述
拉取一段时间内的短信回执状态,包括提交成功量、回执量、回执成功量、回执失败量及失败分布。
URL 示例
POST https://yun.tim.qq.com/v5/tlssmssvr/pullcallbackstatus?sdkappid=xxxxx&random=xxxx
其中,sdkappid
请填写您在 短信控制台 添加应用后生成的实际 SDK AppID,random
请填写成随机数。
请求参数
请求参数如下表所示。
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
begin_date | 是 | number | 开始时间,yyyymmddhh 需要拉取的起始时间,精确到小时 |
end_date | 是 | number | 结束时间,yyyymmddhh 需要拉取的截止时间,精确到小时 |
sig | 是 | string | App 凭证,具体计算方式请参见下方说明 |
time | 是 | number | UNIX 时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败 |
说明:
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_date": 2016090800,
"end_date": 2016090823,
"sig": "c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df",
"time": 1457336869
}
响应参数
响应参数如下表所示。
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
result | 是 | number | 错误码,0表示成功(计费依据),非0表示失败 |
errmsg | 是 | string | 错误消息,result 非0时的具体错误信息 |
data | 否 | object | 应答数据 |
参数data
:
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
status | 是 | number | 短信回执量 |
status_fail | 是 | number | 短信回执失败量 |
status_fail_0 | 是 | number | 运营商内部错误 |
status_fail_1 | 是 | number | 号码无效或空号 |
status_fail_2 | 是 | number | 停机、关机等 |
status_fail_3 | 是 | number | 黑名单 |
status_fail_4 | 是 | number | 运营商频率限制 |
status_success | 是 | number | 短信回执成功量 |
success | 是 | number | 短信提交成功量 |
响应示例:
{
"data": {
"status": 90,
"status_fail": 10,
"status_fail_0": 2,
"status_fail_1": 2,
"status_fail_2": 2,
"status_fail_3": 2,
"status_fail_4": 2,
"status_success": 80,
"success": 100
},
"errmsg": "OK",
"result": 0
}
DEMO
腾讯云短信服务为您提供了 Java SDK、PHP SDK、Python SDK、Node.js SDK 和 C# SDK 供您参考,欢迎查阅。