Add Message Template

Last updated: 2020-09-16 18:13:14

    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
        }
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help