查询短信套餐包信息

最近更新时间:2020-11-03 17:10:16

接口描述

功能描述

查询短信套餐包信息。

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 SDKPHP SDKPython SDKNode.js SDKC# SDK 供您参考,欢迎查阅。