Add Message Template

Last updated: 2018-08-30 18:11:43

1 Protocol Descriptions

Protocol HTTP POST
Encoding format UTF8
URL For example: https://yun.tim.qq.com/v5/tlssmssvr/add_template?sdkappid=xxxxx&random=xxxx
API description Add text SMS (or voice SMS) templates
Note: Enter the applied SDKAppID as sdkappid, and a random number as random.

2 Request Packet

{
    "sig": "c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df", //App credential. For more information on the calculation, please see the following
    "time": 1457336869, //UNIX timestamp, i.e. the time to initiate the request. A failure message will be returned if the time difference between the UNIX timestamp and the system time is greater than 10 minutes
    "title": "xxxxx", //Template name (optional)
    "remark": "xxxxx", //Template notes (optional), such as reason for application and usage scenarios
    "text": "xxxxx", //Template content
    "type": 0 //0: common SMS template; 1: marketing SMS template; 2: voice SMS template
}

Note:
The "sig" field is generated according to the formula sha256(appkey=$appkey&random=$random&time=$time).
The pseudo codes are as follows:

string strAppkey = "5f03a35d00ee52a21327ab048186a2c4"; //The corresponding appkey of sdkappid, which must be kept confidential at the business side.
string strRand = "7226249334"; //The value of the "random" field in the URL
string strTime = "1457336869"; //UNIX timestamp
string sig = sha256(appkey=5f03a35d00ee52a21327ab048186a2c4&random=7226249334&time=1457336869)
           = c13e54f047ed75e821e698730c72d030dc30e5b510b3f8a0fb6fb7605283d7df;

3 Response Packet

{
    "result": 0, //0: Successful. Other values: Failed
    "msg": "", //The specific error message when the "result" is not 0
    "data": {
        "id": 123, //Template ID
        "text": "xxxxx", //Template content
        "status": 1, //0: Approved; 1: Pending approval; 2: Rejected
        "type": 0 //0: common SMS template; 1: marketing SMS template; 2: voice SMS template
    }
}