接口描述
功能描述
拉取一段时间内的短信发送状态,包括发送量、成功量以及计费条数。
URL 示例
POST https://yun.tim.qq.com/v5/tlssmssvr/pullsendstatus?sdkappid=xxxxx&random=xxxx
请求参数
请求参数如下表所示。
参数 | 必选 | 类型 | 描述 |
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