Preface

After reading this article, copy the source code to your project, and you can quickly complete the docking of polar rabbit express interface. The effect of the interface displayed on the official website of polar rabbit express is more suitable for novices, Call the polar rabbit Express query API interface of the express bird to query the logistics delivery status of the polar rabbit express bill No. in all links, including receiving, transportation, transfer center, delivery to sign in, etc. The express bird API interface does not distinguish development languages. It supports program calls in Java, C, PHP, Python, ObjectC and other development languages. The following details the implementation process

1. Complete the preparatory work

1.1 go to express bird website Free registration An account number

1.2. Obtain an apikey for free (required for interface permission verification)

1.3 complete the real name certification process

1.4, order a free package

2.API interface

2.1, test call address: http://sandboxapi.kdniao.com: 8080/kdniaosandbox/gateway/extrafaceinvoke.json

2.2. Official call address: http://api.kdniao.com/api/dist

2.3. Request method: POST

2.4, UTF-8: application/x-www-form-urlencoded;charset=utf-8

2.5, return type: JSON

2.6, debugging page: http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx

2.7 debugging tools: Debug (log in with express bird account)

3. Request parameters (Headers)

4. Request parameter (Body)

5. Return parameter

6. Request complete message (example)

RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JTSD%27%2c%27LogisticCode%27%3a%27jt0000052600488%27%7d&
EBusinessID=1264783&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmVlM2YxYzEzMTM%3d&DataType=2

7. Successful return message (example)

{
"LogisticCode": "JT0000052600488",
"ShipperCode": "JTSD",
"Traces": [],
"State": "0",
"EBusinessID": "1264783",
"Reason": "Business error[No packages available]",
"Success": false
}

Note: this message will be returned if there is no real name authentication, no package is ordered, and the available query volume of the package has been used up
To real name authentication / Learn more about the package

9. No trace return message (example)

{
"LogisticCode": "JT0000052600488",
"ShipperCode": "JTSD",
"Traces": [],
"State": "0",
"EBusinessID": "1264783",
"Reason": "No track information",
"Success": true
}

10. Step by step explanation (version C)

10.1 request packet structure

10.2,C call code example

//Electricity supplier ID
string eEBusinessID = "test1617571";
 //E-commerce encrypts the private key, which is provided by express bird. Take care not to disclose
string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175";
 //Request url
string reqURL = "http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json";
//Request instruction 
string reqType="1002";
//2-json 
string dataType = "2"; 
//UTF-8 for character encoding 
string charset = "UTF-8"; 
//JSON string 
string jsonStr = 
"{\"OrderCode\":\"\",\"ShipperCode\":\"JTSD\",\"LogisticCode\":\"JT0000052600488\"}" ;
//MD5 encryption of (jsonStr+APIKey)
string md5Str=MD5(jsonStr + apiKey, charset);
//Base 64 coding md5Str
string base64Str=base64(md5Str,charset);
//URL encoding (utf-8)
string datasign = HttpUtility.UrlEncode(base64Str, charset); 
//Request message parameters 
string postStr = "RequestType=reqType&EBusinessID= eEBusinessID&RequestData=jsonStr 
&DataSign= datasign&DataType=dataType"; 
//Communication protocol uses Http protocol Post request mode to return track data
string post = SendPost(reqURL, postStr);
//The post data obtained is the complete message returned by the express bird. Next, write a method to parse json to get the field information.

10.3,C call method

///<summary>
    ///String MD5 encryption
    ///</summary>
    ///< param name = "STR" > string to encrypt < / param >
    ///< param name = "charset" > encoding method < / param >
    ///< returns > ciphertext < / returns >
    private string MD5(string str, string charset)
    {
        byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);
        try
        {
            System.Security.Cryptography.MD5CryptoServiceProvider check;
            check = new System.Security.Cryptography.MD5CryptoServiceProvider();
            byte[] somme = check.ComputeHash(buffer);
            string ret = "";
            foreach (byte a in somme)
            {
                if (a < 16)
                    ret += "0" + a.ToString("X");
                else
                    ret += a.ToString("X");
            }
            return ret.ToLower();
        }
        catch
        {
            throw;
        }
    }
    /// <summary>
    ///base64 encoding
    /// </summary>
    ///< param name = "STR" > content < / param >
    ///< param name = "charset" > encoding method < / param >
    /// <returns></returns>
    private string base64(String str, String charset)
    {
        return Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
}
 /// <summary>
    ///Submit data in Post mode and return the source code of the web page
    /// </summary>
    ///< param name = "URL" > the URL to send the request < / param >
    ///< param name = "postData" > request message parameters < / param >
    ///< returns > response results of remote resources < / returns >
    private string SendPost(string url, string postData)
    {
        string result = "";
        byte[] byteData = Encoding.GetEncoding("UTF-8").GetBytes(postData.ToString());
        try
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
            request.ContentType = "application/x-www-form-urlencoded";
            request.Referer = url;
            request.Accept = "*/*";
            request.Timeout = 30 * 1000;
            request.UserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729)";
            request.Method = "POST";
            request.ContentLength = byteData.Length;
            Stream stream = request.GetRequestStream();
            stream.Write(byteData, 0, byteData.Length);
            stream.Flush();
            stream.Close();
            HttpWebResponse response = (HttpWebResponse)request.GetResponse();
            Stream backStream = response.GetResponseStream();
            StreamReader sr = new StreamReader(backStream, Encoding.GetEncoding("UTF-8"));
            result = sr.ReadToEnd();
            sr.Close();
            backStream.Close();
            response.Close();
            request.Abort();
        }
        catch (Exception ex)
        {
            result = ex.ToString();
        }
        return result;
    }

11. Application effect of polar rabbit Express query interface

Completion can achieve the display effect of polar rabbit official website.

12. About signature

Express bird and the third-party e-commerce company system docking, there is a certain security mechanism. Use IP authentication and signature
The specific scheme is as follows:

Prevent data tampering 
Five required (R) parameters are passed in the POST request 
RequestData = = data content (URL Code: UTF-8) 
EBusinessID = = user ID 
RequestType = request instruction type 
DataSign = = data content signature: encrypt (request content (not encoded) + ApiKey) with MD5, and then Base64 
Encoding, and finally URL(utf-8) encoding 
Datatype = = 2 (return data type is json) 
Note:
After the DataSign is generated, the other party receives the data and signs with the same algorithm (the push interface RequestType is 
101 / 102 does not need URL encoding), generates a summary, and compares whether the two summaries are the same. If they are different, data tampering occurs in the process of transmission. 
Authentication of calling interface 
After registering as a express bird user, the corresponding user ID and APIKey will be generated. The user ID is equivalent to the user name, 
APIKey is equivalent to password.

13. Return code definition