C#使用快递鸟接口制作快递查询小工具

虽然目前市面上快递查询工具已经很多了,知名的有快递100、菜鸟裹裹等,但是想要量身定制的快递查询工具还是需要自己动手去做,前几天正好需要写一个快递查询工具,所以就趁着这个机会把制作过程中的重点流程记录下来,分享给他人,也给自己加深下印象。工具的主要功能如下(WEB版):1.管理用户在后台可以录入订单信息

2.管理用户可以在后台录入订单后直接查询到快递轨迹

3.公共用户在前台可以输入手机号查询到订单信息

4.公共用户在前台点击订单后可以直接查询到快递轨迹


其实具体实现还是比较简单的,只要把快递接口搞定,能接收到查询结果,其他的就没什么难度了。

首先祭出快递鸟官方API:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web;
using System.Net;
using System.IO;
 
namespace Microsystem.Models
{
    public class KdApiSearch
    {
        //电商ID
        private string EBusinessID = "128xxxx";
        //电商加密私钥,快递鸟提供,注意保管,不要泄漏
        private string AppKey = "";
        //请求url
        private string ReqURL = "http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx";

        /// <summary>
        /// Json方式 查询订单物流轨迹
        /// </summary>
        /// <returns></returns>
        public string getOrderTracesByJson(string shipperCode,string logisticCode)
        {
            string requestData = "{'OrderCode':'','ShipperCode':'"+shipperCode+ "','LogisticCode':'"+ logisticCode + "'}";

            Dictionary<string, string> param = new Dictionary<string, string>();
            param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8));
            param.Add("EBusinessID", EBusinessID);
            param.Add("RequestType", "1002");
            string dataSign = encrypt(requestData, AppKey, "UTF-8");
            param.Add("DataSign", HttpUtility.UrlEncode(dataSign, Encoding.UTF8));
            param.Add("DataType", "2");

            string result = sendPost(ReqURL, param);

            //根据公司业务处理返回的信息......

            return result;
        }

        /// <summary>
        /// Post方式提交数据,返回网页的源代码
        /// </summary>
        /// <param name="url">发送请求的 URL</param>
        /// <param name="param">请求的参数集合</param>
        /// <returns>远程资源的响应结果</returns>
        private string sendPost(string url, Dictionary<string, string> param)
        {
            string result = "";
            StringBuilder postData = new StringBuilder();
            if (param != null && param.Count > 0)
            {
                foreach (var p in param)
                {
                    if (postData.Length > 0)
                    {
                        postData.Append("&");
                    }
                    postData.Append(p.Key);
                    postData.Append("=");
                    postData.Append(p.Value);
                }
            }
            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.Message;
            }
            return result;
        }

        ///<summary>
        ///电商Sign签名
        ///</summary>
        ///<param name="content">内容</param>
        ///<param name="keyValue">Appkey</param>
        ///<param name="charset">URL编码 </param>
        ///<returns>DataSign签名</returns>
        private string encrypt(String content, String keyValue, String charset)
        {
            if (keyValue != null)
            {
                return base64(MD5(content + keyValue, charset), charset);
            }
            return base64(MD5(content, charset), charset);
        }

        ///<summary>
        /// 字符串MD5加密
        ///</summary>
        ///<param name="str">要加密的字符串</param>
        ///<param name="charset">编码方式</param>
        ///<returns>密文</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编码
        /// </summary>
        /// <param name="str">内容</param>
        /// <param name="charset">编码方式</param>
        /// <returns></returns>
        private string base64(String str, String charset)
        {
            return Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
        }
    }
}

然后自写接口调用API,并要求该接口调用时必须传递快递公司名称和快递单号:

 /// <summary>
        /// 查询快递
        /// </summary>
        /// <param name="shipperCode"></param>
        /// <param name="logisticCode"></param>
        /// <returns></returns>
        [HttpPost]
        public ActionResult SearchExpress(string shipperCode, string logisticCode)
        {
            if (shipperCode == "顺丰速运")
                shipperCode = "SF";
            if (shipperCode == "百世快递")
                shipperCode = "HTKY";
            if (shipperCode == "中通快递")
                shipperCode = "ZTO";
            if (shipperCode == "申通快递")
                shipperCode = "STO";
            if (shipperCode == "圆通速递")
                shipperCode = "YTO";
            if (shipperCode == "韵达速递")
                shipperCode = "YD";
            if (shipperCode == "邮政快递包裹")
                shipperCode = "YZPY";
            if (shipperCode == "EMS")
                shipperCode = "EMS";
            if (shipperCode == "天天快递")
                shipperCode = "HHTT";
            if (shipperCode == "京东快递")
                shipperCode = "JD";
            if (shipperCode == "优速快递")
                shipperCode = "UC";
            if (shipperCode == "德邦快递")
                shipperCode = "DBL";
            if (shipperCode == "宅急送")
                shipperCode = "ZJS";
            KdApiSearch kdApiSearch = new KdApiSearch();
            string returnjson = kdApiSearch.getOrderTracesByJson(shipperCode, logisticCode);
            return Json(returnjson);
        }

然后使用AJAX调用自写的查询快递接口,传递快递名称+快递单号,解析数据显示到页面上就OK了,我这里用的是bootstrap-table,大家可以根据自己的需要更换。

 function SercahExpress() {
            $.ajax({
                url: "/Default/SearchExpress",
                type: "POST",
                data: { shipperCode: $("#ExpressName").text(), logisticCode: $("#ExpressNumber").text() },
                success: function (data) {
                    data = JSON.parse(data);
                    $('#tablesuccess').bootstrapTable({
                        data: data["Traces"],
                        method: 'POST',                      //请求方式(*)
                        striped: true,                      //是否显示行间隔色
                        columns: [{
                            field: 'AcceptTime',
                            title: '时间',
                            datasortable: true
                        }, {
                            field: 'AcceptStation',
                            title: '状态'
                        }]
                    });
                }
            });
        }

至此核心功能就完成了,其他的录入单号保存到数据库里什么的就不赘述了,不懂得移步baidu哦!


附效果图一张:

THE END