Delivery Statistics

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

    1 Protocol Descriptions

    Protocol HTTP POST
    Encoding format UTF8
    URL For example:
    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

    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.

    Was this page helpful?

    Was this page helpful?

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