Delivery Statistics

Last updated: 2018-08-30 18:14:26

PDF

1 Protocol Descriptions

Protocol HTTP POST
Encoding format UTF8
URL For example: https://yun.tim.qq.com/v5/tlssmssvr/pullsendstatus?sdkappid=xxxxx&random=xxxx
API description Pull the SMS delivery status in a certain period of time (the number of SMS messages sent, the number of SMS messages sent successfully, the number of SMS messages billed)
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
    "begin_date": 2016090800, //Time to start pulling, which is accurate to hour. Format: yyyymmddhh
    "end_date": 2016090823 //Time to end pulling, which is accurate to hour. Format: yyyymmddhh
}

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
    "errmsg": "OK", //The specific error message when the "result" is not 0
    "data": { //It is valid when "result" is 0 
        "request": 101, //SMS messages submitted
        "success": 100, //SMS messages submitted successfully
        "bill_number": 120 // SMS messages billed. For example, among all SMS messages that are submitted successfully, 20 messages are long messages, each with a length of 80 bytes. A long SMS message is divided into two messages. So, the number of SMS messages billed is 80*1+20*2=120.
    }
}