免費快遞查詢api技術文檔【C#】

1、免費快遞查詢api技術文檔【C#】1.1 即時查詢接口1.1.1 功能說明 物流軌跡查詢-使用的物流單號和快遞單號即可實現(xiàn)查詢物流信息。1.1.2 接口規(guī)則 (1)、查詢接口支持按照運單號查詢(單個查詢)。 (2)、指定的物流運單號選擇相應的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的信息。如EMS物流單號應選擇快遞公司編碼（EMS）(3)、接口來源：快遞鳥(4)、返回的物流跟蹤信息按照發(fā)生的時間升序排列。 (5)、接口指令1002。1.1.3 系統(tǒng)級輸入參數(shù)參數(shù)名稱類型必須要求說明RequestDataStringR請求內容，JSON格式,和DataType一致EBusinessIDStr

2、ingR電商IDRequestTypeStringR請求指令類型：1002DataSignStringR數(shù)據(jù)內容簽名DataTypeStringR請求、返回數(shù)據(jù)類型： 2-json； 1.1.4 應用級輸入參數(shù)參數(shù)名稱類型必須要求說明OrderCodeStringO訂單編號ShipperCodeStringR快遞公司編碼LogisticCodeStringR物流單號1.1.5 返回結果參數(shù)參數(shù)名稱類型必須要求說明EBusinessIDStringR電商用戶IDOrderCodeStringO訂單編號ShipperCodeStringR快遞公司編碼LogisticCodeStringR物流運單號

3、CallBackStringO用戶標識SuccessBoolR成功與否ReasonStringO失敗原因StateStringR物流狀態(tài): 2-在途中，3-簽收,4-問題件Traces/物流軌跡詳情AcceptTimeStringR時間AcceptStationStringR描述RemarkStringO備注1.1.6 JSON請求示例 "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118650888018"1.

4、1.7 JSON返回示例沒有物流軌跡的 "EBusinessID": "1109259", "Traces": , "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": true, "Reason": null有物流軌跡的 "EBusinessID":

5、 "1109259", "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": true, "CallBack":"", "State": 3, "Reason": null, "Traces": "AcceptTime&q

6、uot;: "2014/06/25 08:05:37", "AcceptStation": "正在派件.(派件人:鄧裕富,電話深圳 市", "Remark": null , "AcceptTime": "2014/06/25 04:01:28", "AcceptStation": "快件在 深圳集散中心 ,準備送往下一站 深圳 深圳市", "Remark": null , "Acc

7、eptTime": "2014/06/25 01:41:06", "AcceptStation": "快件在 深圳集散中心 深圳市", "Remark": null , "AcceptTime": "2014/06/24 20:18:58", "AcceptStation": "已收件深圳市", "Remark": null , "AcceptTime": "2014/06/2

8、4 20:55:28", "AcceptStation": "快件在 深圳 ,準備送往下一站 深圳集散中心 深圳市", "Remark": null , "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "派件已簽收深圳市", "Remark": null , "AcceptTime": "2014/06/25 10:23:03"

9、, "AcceptStation": "簽收人是：已簽收深圳市", "Remark": null 1.2 物流軌跡（訂閱查詢）1.2.1 功能說明訂閱查詢接口是為用戶提供的定制化服務，用戶可將訂單信息通過接口訂閱給快遞公司，快遞公司更新軌跡后，將實時轉換成標準接口形式，推送給用戶，起到實時推送的作用，提高效率。同時用戶訂閱的數(shù)據(jù)還能選擇是否通知快遞員上門，實現(xiàn)在線下單功能。1.2.2 接口規(guī)則 (1)、訂單接收的信息(分給了的網點，業(yè)務員的信息)，會通過推送接口推給客戶?？蛻粜枰匆髮崿F(xiàn)接口。 (2)、僅支持Json格式。(3)、請

10、求指令1008。(4)、測試接口地址：http:/testapi.kdniao.cc:8081/api/dist(5)、聯(lián)調通過后請更換為正式地址：http:/api.kdniao.cc/api/dist(6)、分發(fā)及訂閱接口需要客戶方實現(xiàn)回調接口，回調RequestType(1008)1.2.3 系統(tǒng)級輸入參數(shù)參數(shù)名稱類型必須要求說明RequestDataStringR請求內容為JSON格式 EBusinessIDStringR電商IDRequestTypeStringR請求指令類型：1008DataSignStringR數(shù)據(jù)內容簽名DataTypeStringR請求、返回數(shù)據(jù)類型：2-js

11、on；1.2.4 應用級輸入參數(shù)參數(shù)名稱類型是否必須描述CallBackStringO用戶自定義回調信息MemberIDStringO會員標識(備用字段)CustomerNameStringO電子面單客戶賬號（與快遞網點申請）CustomerPwdStringO電子面單密碼SendSiteStringO收件網點標識ShipperCodeStringR快遞公司編碼LogisticCodeStringR快遞單號OrderCodeStringO訂單編號MonthCodeStringO月結編碼PayTypeIntO郵費支付方式:1-現(xiàn)付，2-到付，3-月結，4-第三方支付ExpTypeStringO快

12、遞類型：1-標準快件CostDoubleO寄件費（運費）OtherCostDoubleO其他費用ReceiverCompanyStringO收件人公司NameStringO收件人TelStringO電話MobileStringO手機PostCodeStringO收件人郵編ProvinceNameStringO收件?。ㄈ鐝V東省，不要缺少“省”）CityNameStringO收件市（如深圳市，不要缺少“市”）ExpAreaNameStringO收件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStringO收件人詳細地址SenderCompanyStringO發(fā)件人公司NameStringO

13、發(fā)件人TelStringO發(fā)件人電話MobileStringO發(fā)件人手機PostCodeStringO發(fā)件人郵編ProvinceNameStringO發(fā)件省（如廣東省，不要缺少“省”）CityNameStringO發(fā)件市（如深圳市，不要缺少“市”）ExpAreaNameStringO發(fā)件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStringO發(fā)件詳細地址StartDateStringO上門取貨時間段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有時間格式相同EndDateStringOWeightDoubleO物品總重量kgQuantityIntO件

14、數(shù)/包裹數(shù)VolumeDoubleO物品總體積m3RemarkStringO備注IsNoticeIntO是否分發(fā)到快遞公司：1-不分發(fā)；0-分發(fā).默認為0AddServiceNameString0增值服務名稱ValueString0增值服務值CustomerIDString0客戶標識(選填)CommodityGoodsNameStringO商品名稱GoodsCodeStringO商品編碼GoodsquantityIntO件數(shù)GoodsPriceDoubleO商品價格GoodsWeightDoubleO商品重量kgGoodsDescStringO商品描述GoodsVolDoubleO商品體積m3

15、1.2.5 返回結果參數(shù)l 同步返回參數(shù)名稱類型必須要求說明EBusinessIDStringR電商用戶IDUpdateTimeStringR時間SuccessBoolR成功與否:true,falseReasonStringO失敗原因EstimatedDeliveryTimeStringO訂單預計到貨時間yyyy-mm-dd注：訂單分發(fā)會自動觸發(fā)運單訂閱推送1.2.6 JSON請求示例 "ShipperCode":"SF", "OrderCode":"SF201608081055208281", "Log

16、isticCode":"3100707578976", "PayType":"1", "ExpType":"1", "CustomerName":"", "CustomerPwd":"", "MonthCode":"", "IsNotice":"0", "Sender": "Name":&

17、quot;1255760", "Tel":"", "Mobile":"quot;, "ProvinceName":"廣東省", "CityName":"深圳市", "ExpAreaName":"福田區(qū)", "Address":"測試地址" , "Receiver": "Name":"1

18、255760", "Tel":"", "Mobile":"quot;, "ProvinceName":"廣東省", "CityName":"深圳市", "ExpAreaName":"龍華新區(qū)", "Address":"測試地址2" , "Commodity": "GoodsName":"

19、;書本" 1.2.7 JSON返回示例 "EBusinessID": "1151847", "UpdateTime": "2016-08-09 16:42:38", "Success": true, "Reason": "" "EstimatedDeliveryTime":"2016-8-12"1.2.8 C# 對接demousing System;using System.Collections.Gene

20、ric;using System.Linq;using System.Text;using System.Web;using System.Net;using System.IO; namespace KdGoldAPI public class KdApiSearchDemo /電商ID private string EBusinessID = "1237100" /電商加密私鑰，注意保管，不要泄漏 private string AppKey = "518a73d8-1f7f-441a-b644-33e77b49d846" /請求url private

21、 string ReqURL = "http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx" / <summary> / Json方式 查詢訂單物流軌跡 / </summary> / <returns></returns> public string getOrderTracesByJson() string requestData = "'OrderCode':'','ShipperCode':'SF&#

22、39;,'LogisticCode':'589707398027'" Dictionary<string, string> param = new Dictionary<string, string>(); param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8); param.Add("EBusinessID", EBusinessID); param.Add("RequestType&

23、quot;, "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); /根據(jù)公司業(yè)務處理返回的信息. return result; / <s

24、ummary> / XML方式 查詢訂單物流軌跡 / </summary> / <returns></returns> public string getOrderTracesByXml() string requestData = "<?xml version="1.0" encoding="utf-8" ?>" + "<Content>" + "<OrderCode></OrderCode>" + &q

25、uot;<ShipperCode>SF</ShipperCode>" + "<LogisticCode>589707398027</LogisticCode>" + "</Content>" Dictionary<string, string> param = new Dictionary<string, string>(); param.Add("RequestData", HttpUtility.UrlEncode(requestData

26、, 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",

27、"1"); string result = sendPost(ReqURL, param); /根據(jù)公司業(yè)務處理返回的信息. return result; / <summary> / Post方式提交數(shù)據(jù)，返回網頁的源代碼 / </summary> / <param name="url">發(fā)送請求的 URL</param> / <param name="param">請求的參數(shù)集合</param> / <returns>遠程資源的響應結果</re

28、turns> 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("&"); p

29、ostData.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&qu

30、ot; 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" r

31、equest.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 S

32、treamReader(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