免費(fèi)快遞查詢api技術(shù)文檔【C#】

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

2、ingR電商IDRequestTypeStringR請(qǐng)求指令類型：1002DataSignStringR數(shù)據(jù)內(nèi)容簽名DataTypeStringR請(qǐng)求、返回?cái)?shù)據(jù)類型： 2-json； 1.1.4 應(yīng)用級(jí)輸入?yún)?shù)參數(shù)名稱類型必須要求說明OrderCodeStringO訂單編號(hào)ShipperCodeStringR快遞公司編碼LogisticCodeStringR物流單號(hào)1.1.5 返回結(jié)果參數(shù)參數(shù)名稱類型必須要求說明EBusinessIDStringR電商用戶IDOrderCodeStringO訂單編號(hào)ShipperCodeStringR快遞公司編碼LogisticCodeStringR物流運(yùn)單號(hào)

3、CallBackStringO用戶標(biāo)識(shí)SuccessBoolR成功與否ReasonStringO失敗原因StateStringR物流狀態(tài): 2-在途中，3-簽收,4-問題件Traces/物流軌跡詳情AcceptTimeStringR時(shí)間AcceptStationStringR描述RemarkStringO備注1.1.6 JSON請(qǐng)求示例 "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": "快件在 深圳集散中心 ,準(zhǔn)備送往下一站 深圳 深圳市", "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": "快件在 深圳 ,準(zhǔn)備送往下一站 深圳集散中心 深圳市", "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 功能說明訂閱查詢接口是為用戶提供的定制化服務(wù)，用戶可將訂單信息通過接口訂閱給快遞公司，快遞公司更新軌跡后，將實(shí)時(shí)轉(zhuǎn)換成標(biāo)準(zhǔn)接口形式，推送給用戶，起到實(shí)時(shí)推送的作用，提高效率。同時(shí)用戶訂閱的數(shù)據(jù)還能選擇是否通知快遞員上門，實(shí)現(xiàn)在線下單功能。1.2.2 接口規(guī)則 (1)、訂單接收的信息(分給了的網(wǎng)點(diǎn)，業(yè)務(wù)員的信息)，會(huì)通過推送接口推給客戶?？蛻粜枰匆髮?shí)現(xiàn)接口。 (2)、僅支持Json格式。(3)、請(qǐng)

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

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

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

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

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

15、1.2.5 返回結(jié)果參數(shù)l 同步返回參數(shù)名稱類型必須要求說明EBusinessIDStringR電商用戶IDUpdateTimeStringR時(shí)間SuccessBoolR成功與否:true,falseReasonStringO失敗原因EstimatedDeliveryTimeStringO訂單預(yù)計(jì)到貨時(shí)間yyyy-mm-dd注：訂單分發(fā)會(huì)自動(dòng)觸發(fā)運(yùn)單訂閱推送1.2.6 JSON請(qǐng)求示例 "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":"測(cè)試地址" , "Receiver": "Name":"1

18、255760", "Tel":"", "Mobile":"quot;, "ProvinceName":"廣東省", "CityName":"深圳市", "ExpAreaName":"龍華新區(qū)", "Address":"測(cè)試地址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# 對(duì)接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" /請(qǐng)求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è)務(wù)處理返回的信息. 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è)務(wù)處理返回的信息. return result; / <summary> / Post方式提交數(shù)據(jù)，返回網(wǎng)頁(yè)的源代碼 / </summary> / <param name="url">發(fā)送請(qǐng)求的 URL</param> / <param name="param">請(qǐng)求的參數(shù)集合</param> / <returns>遠(yuǎn)程資源的響應(yīng)結(jié)果</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">內(nèi)容</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