发送数据统计

最近更新时间:2019-12-17 10:11:48

我的收藏

接口描述

功能描述

拉取一段时间内的短信发送状态,包括发送量、成功量以及计费条数。

URL 示例

POST https://yun.tim.qq.com/v5/tlssmssvr/pullsendstatus?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
参数
必选
类型
描述
bill_number
number
短信计费条数,例如提交成功量为100条,其中有20条是长短信(长度为80字)被拆分成2条,则计费条数为: 80 * 1 + 20 * 2 = 120 条。
request
number
短信提交量。
success
number
短信提交成功量。
响应示例:
{
"result": 0,
"errmsg": "OK",
"data": {
"bill_number": 120,
"request": 101,
"success": 100
}
}

DEMO

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