查询短信套餐包信息-短信-文档中心-腾讯云

接口描述

功能描述

查询短信套餐包信息。

URL 示例

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

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

请求参数

请求参数如下表所示。

参数	必选	类型	描述
offset	否	number	分页拉取的偏移量
length	是	number	每次拉取的套餐包个数
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;

请求示例：

{
    "offset": 0,
    "length":10,
    "sig":"c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7d",
    "time":1531463729
}

响应参数

响应参数如下表所示。

参数	必选	类型	描述
total	是	number	套餐包个数
data	是	array	套餐包详情

数组 data 元素参数：

参数	必选	类型	描述
create_time	是	string	套餐包创建时间
from_time	是	string	套餐包生效时间
to_time	是	string	套餐包过期时间
amount	是	number	套餐包条数
type	是	number	0表示赠送套餐包，1表示购买套餐包
package_id	是	number	套餐包 ID
used	是	number	当前使用量

响应示例：

{
    "total": 6,
    "data": [{
        "from_time": "2018-07-01 00:00:00",
        "to_time": "2018-07-31 23:59:59",
        "create_time": "2018-07-01 00:00:03",
        "amount": 100,
        "type": 0,
        "package_id": 1000200003,
        "used": 5
    }, {
        "from_time": "2018-06-01 00:00:00",
        "to_time": "2018-06-30 23:59:59",
        "create_time": "2018-06-01 00:00:03",
        "amount": 100,
        "type": 0,
        "package_id": 1000158193,
        "used": 6
    }]
}

DEMO

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