順豐目前提供了兩種對接方式：

一種是開發者自助對接，需要註冊豐橋賬戶後，申請成為開發者，然後上傳電子面單等操作，較為繁瑣；

還有一種方式就是這裡要重點介紹的，第三方軟體對接（例如快遞鳥），對接起來非常方便。

物流軌跡查詢-使用的物流單號和快遞單號即可實現查詢物流資訊。對接在電商網站或ERP系統上後，僅輸入單號就可以查詢物流，不需要物流編碼。是透過兩個介面實現的，一個是快遞物流查詢介面，一個是單號識別的介面

介面提供：快遞鳥

介面名稱：即時查詢介面+單號識別介面

編寫語言：C#

順豐快遞單號介面透過快遞鳥介面對接簡單方便，順豐速運快遞查詢介面API和電子面單介面可以透過快遞鳥對接，透過順豐單號和手機號後四位查詢軌跡資訊，如果是透過快遞鳥下單獲得的順豐單號，可透過單號直接查詢，具體下載快遞鳥介面技術文件檢視介面說明。

即時查詢介面demo：

using System;
usingSystem.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web;
using System.Net;
using System.IO;
 
namespace KdGoldAPI
{
    public class KdApiSearchDemo
    {
        //電商ID
        private string EBusinessID = "？？？？？？";
        //電商加密私鑰，注意保管，不要洩漏
        private string AppKey = "？？？？？？";
        //請求url
        private string ReqURL ="
 
        /// 
        /// Json方式 查詢訂單物流軌跡
        /// 
        /// 
        public string getOrderTracesByJson()
        {
            string requestData ="{'OrderCode':'','ShipperCode':'SF','LogisticCode':'589707398027'}";
 
            Dictionaryparam = new Dictionary();
            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;
        }
 
        /// 
        /// Post方式提交資料，返回網頁的原始碼
        /// 
        /// 傳送請求的 URL
        /// 請求的引數集合
        /// 遠端資源的響應結果
        private string sendPost(string url,Dictionary param)
        {
            string result = "";
            StringBuilder postData = newStringBuilder();
            if (param != null &¶m.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 CLR2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 
3.0.4506.2152; .NET CLR3.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 = newStreamReader(backStream, Encoding.GetEncoding("UTF-8"));
                result = sr.ReadToEnd();
                sr.Close();
                backStream.Close();
                response.Close();
                request.Abort();
            }
            catch (Exception ex)
            {
                result = ex.Message;
            }
            return result;
        }
 
        ///
        ///電商Sign簽名
        ///
        ///內容
        ///Appkey
        ///URL編碼
        ///DataSign簽名
        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);
        }
 
        ///
        /// 字串MD5加密
        ///
        ///要加密的字串
        ///編碼方式
        ///密文
        private string MD5(string str, stringcharset)
        {
            byte[] buffer =System.Text.Encoding.GetEncoding(charset).GetBytes(str);
            try
            {
                System.Security.Cryptography.MD5CryptoServiceProvidercheck;
                check = newSystem.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;
            }
        }
 
        /// 
        /// base64編碼
        /// 
        /// 內容
        /// 編碼方式
        /// 
        private string base64(String str,String charset)
        {
            returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
        }
    }
}

單號識別介面demo：

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Text;
using System.Web;
 
namespace KdGoldAPI
{
    public class KdApiOrderDistinguish
    {
        //電商ID
        private string EBusinessID = "？？？？？？";
        //電商加密私鑰，注意保管，不要洩漏
        private string AppKey = "？？？？？？？";
        //請求url
        //測試環境
        private string ReqURL ="
        //正式環境
        //private string ReqURL ="
 
        /// 
        /// Json方式  單號識別
        /// 
        /// 
        public string orderTracesSubByJson()
        {
            string requestData = "{'LogisticCode':'3967950525457'}";
 
            Dictionaryparam = new Dictionary();
            param.Add("RequestData",HttpUtility.UrlEncode(requestData, Encoding.UTF8));
            param.Add("EBusinessID",EBusinessID);
            param.Add("RequestType","2002");
            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;
        }
 
        /// 
        /// Post方式提交資料，返回網頁的原始碼
        /// 
        /// 傳送請求的 URL
        /// 請求的引數集合
        /// 遠端資源的響應結果
        private string sendPost(string url,Dictionary param)
        {
            string result = "";
            StringBuilder postData = newStringBuilder();
            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 CLR2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR3.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 = newStreamReader(backStream, Encoding.GetEncoding("UTF-8"));
                result = sr.ReadToEnd();
                sr.Close();
                backStream.Close();
                response.Close();
                request.Abort();
            }
            catch (Exception ex)
            {
                result = ex.Message;
            }
            return result;
        }
 
        ///
        ///電商Sign簽名
        ///
        ///內容
        ///Appkey
        ///URL編碼
        ///DataSign簽名
        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);
        }
 
        ///
        /// 字串MD5加密
        ///
        ///要加密的字串
        ///編碼方式
        ///密文
        private string MD5(string str, stringcharset)
        {
            byte[] buffer =System.Text.Encoding.GetEncoding(charset).GetBytes(str);
            try
            {
               System.Security.Cryptography.MD5CryptoServiceProvider check;
                check = newSystem.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;
            }
        }
 
        /// 
        /// base64編碼
        /// 
        /// 內容
        /// 編碼方式
        /// 
        private string base64(String str,String charset)
        {
            returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
        }
    }
}

順豐快遞單號查詢API介面demo免費對接【快遞鳥API】

相關文章