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. |
{
"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;
{
"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
}
}
Was this page helpful?