接口描述
功能描述
查询短信套餐包信息。
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 供您参考，欢迎查阅。