回执数据统计

最近更新时间:2019-07-02 12:58:43

接口描述

功能描述

拉取一段时间内的短信回执状态,包括提交成功量、回执量、回执成功量、回执失败量及失败分布。

URL 示例

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

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

请求参数

{
    "begin_date": 2016090800,
    "end_date": 2016090823,
    "sig": "c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df",
    "time": 1457336869
}
参数 必选 类型 描述
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;

响应参数

{
    "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
}
参数 必选 类型 描述
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 短信提交成功量

DEMO

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