免費快遞接口api

1、免費快遞接口api接口地址：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx支持格式：json 請求方式：HTTP POST接口平臺：快遞鳥免費查詢接口 請求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。順豐快遞接口api申請JSON請求/返回示例：1.請求       "OrderCode": "", 

2、;      "ShipperCode": "SF",       "LogisticCode": "118650888018"2.返回沒有物流軌跡的 "EBusinessID": "1109259", "Traces": , "OrderCode": "", &quo

3、t;ShipperCode": "SF", "LogisticCode": "118461988807", "Success": false, "Reason": null有物流軌跡的 "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "SF", "LogisticCode": &q

4、uot;118461988807", "Success": true, "State": 3, "Reason": null, "Traces": "AcceptTime": "2014/06/25 08:05:37", "AcceptStation": "正在派件.(派件人:鄧裕富,電話深圳 市", "Remark": null , "AcceptTime":

5、 "2014/06/25 04:01:28", "AcceptStation": "快件在 深圳集散中心 ,準備送往下一站 深圳 深圳市", "Remark": null , "AcceptTime": "2014/06/25 01:41:06", "AcceptStation": "快件在 深圳集散中心 深圳市", "Remark": null , "AcceptTime": "201

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

7、uot;, "AcceptStation": "派件已簽收深圳市", "Remark": null , "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "簽收人是：已簽收深圳市", "Remark": null 注：接口及簽名說明1）、支持http傳輸協(xié)議2）、支持的數據傳輸格式 Json/Xml(暫不支持<content/>這種形式)。 編碼格式：UTF-8 交互

8、協(xié)議上統(tǒng)一用UTF-8，避免傳遞中文數據出現(xiàn)亂碼。3）、接入步驟 注冊成為用戶(注：注冊成功選擇服務立即使用，無需審批)。注冊成功后，登錄就可以查看ID和key。 注冊方式通過網絡平臺：按照接口官網提示進行注冊申請，注冊成功并且登錄，將得到一組電商ID和AppKey。電商ID是調用接口服務的身份證明，不可更改、不可轉用，AppKey是應用訪問API的簽名附加密鑰，必須妥善保存。兩者關系類似于登錄帳號和密碼，兩者都會在簽名和業(yè)務參數中使用。注冊成功登錄之后認證：即可申請接口 申請后ID和KEY自動激活(1) 開發(fā)服務開發(fā)自身業(yè)務的服務，服務需按照后面接口的定義規(guī)則。(2) 查看接口調用的DEMO

9、物流技術接口提供調用物流接口的DEMO(.Net版本)，包括網上在線訂單下單、物流軌跡查詢等物流行業(yè)標準化的下單操作流程與數據查詢格式。提交接入處理的相關代碼如有不明白的地方可與物流技術接口人協(xié)作開發(fā)。DEMO下載地址： 4）、接口數據包結構圖例 - 數據包結構 (系統(tǒng)級數據)5）、XML范例/JSON 范例 string userID = "1109259" string keyValue = "56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17"/加密私鑰，由發(fā)貨通提供 string url = "http:/api.

10、kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx" /請求地址 string DataType = "1" /1-xml;2-json string charset="UTF-8"/字符編碼采用UTF-8 string xmlStr = "<Content><OrderCode></OrderCode><ShipperCode>SF</ShipperCode><LogisticCode>118650888088&

11、lt;/LogisticCode></Content>"/ XML字符串 string xmlStr = ""OrderCode":"","ShipperCode":"SF","LogisticCode":"118461988807"" / JSON字符串string datasign = MD5(xmlStr+keyValue, "UTF-8");/生成加密簽名加密通過對參數xmlStr+ keyValue

12、得到加密后的字符串string PostStr = "RequestType=1002&EBusinessID= userID &RequestData=xmlStr &DataSign= datasign&DataType=DataType" /請求報文參數string post = this.DoPost(url, PostStr);/ 通訊協(xié)議使用Http協(xié)議Post請求方式6）、流程示意圖7）、網關地址測試接口：http:/api.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx測試

13、電商ID=1237100，AppKey=518a73d8-1f7f-441a-b644-33e77b49d846正式接口：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx注意：正式(自行注冊)環(huán)境下使用時，需提供請求的IP給接口登記8）、關于簽名接口和第三方電子商務公司系統(tǒng)進行對接，有一定的安全機制。采用IP認證加簽名的方式對接，具體方案如下：(1) 防止數據被篡改在POST請求中會傳遞5個參數4個必須參數：RequestType=請求指令類型EBusinessID=電商IDRequestData=數據內容(URL編碼:UTF-8)

14、DataSign= 簽名摘要(URL編碼:UTF-8(base64(MD5(數據內容 +AppKey)1個可選參數：DataType=返回數據類型(1-xml,2-json；默認為2格式)注：DataSign生成后，對方接收到數據后，以同樣的算法進行簽名，生成摘要，對比兩者的摘要是否相同，如果不同，說明傳遞過程中發(fā)生數據篡改，對接過程中如有不明白之處可雙方技術協(xié)作進行(2) 調用接口的身份認證注冊成為接口用戶后，會生成對應的電商ID和AppKey，電商ID相當于用戶名，AppKey相當于密碼。注：請勿遺漏或傳遞可能遞增大接口調用維護舉例說明：(a) 假設RequestData (XML)內容為

15、： <Content><ShipperCode>SF</ShipperCode><LogisticCode>118954907573</LogisticCode></Content>，經過URL(UTF-8)編碼的內容為%3cContent%3e%3cShipperCode%3eSF%3c%2fShipperCode%3e%3cLogisticCode%3e118954907573%3c%2fLogisticCode%3e%3c%2fContent%3e， EBusinessID為1109259，AppKey為56da2c

16、f8-c8a2-44b2-b6fa-476cd7d1ba17(b) 那么DataSign簽名的內容為<Content><ShipperCode>SF</ShipperCode><LogisticCode>118954907573</LogisticCode></Content>56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17，經過md5和base64后的內容就為YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE=，在經過URL(UTF-8)編碼的內容為YzBjOD

17、A3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE%3d(c) 最終要發(fā)送的數據為RequestType=1002&EBusinessID=1109259&RequestData =%3cContent%3e%3cShipperCode%3eSF%3c%2fShipperCode%3e%3cLogisticCode%3e118954907573%3c%2fLogisticCode%3e%3c%2fContent%3e &DataSign = YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE%3d& D

18、ataType=2(d) 接收方收到數據后，獲得EBusinessID 和RequestData和DataSign等這幾個數據。(e) 接收方對EBusinessID 得到AppKey，RequestData+AppKey的數據進行md5和base64后的內容就為YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE=(f) 接收方判斷簽名后的數據跟傳遞過來的DataSign是否一致，如果一致進行業(yè)務操作，如果不一直返回錯誤。9）、(C#)DataSign簽名加密代碼/<summary>/電商Sign簽名/</summary>/<p

19、aram name="content">內容</param>/<param name="keyValue">Appkey</param>/<param name="charset">URL編碼 </param>/<returns>DataSign簽名</returns>Public String Encrypt (String content, String keyValue, String charset)if (keyValue != nul

20、l)return base64(MD5(content + keyValue, charset), charset);return base64(MD5(content, charset), charset);/<summary>/ 字符串MD5加密/</summary>/<param name="Text">要加密的字符串</param>/<returns>密文</returns>Private string MD5(string Text, string charset)byte buffer =

21、System.Text.Encoding.GetEncoding(charset).GetBytes(Text);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 +

22、= "0" + a.ToString("X");else ret += a.ToString("X"); return ret.ToLower();catch throw; Private static string base64(String str, String charset)returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str);10）、PHP demo<?php/電商IDdefined('EBus

23、inessID') or define('EBusinessID', 1237100);/電商加密私鑰，注意保管，不要泄漏defined('AppKey') or define('AppKey', '518a73d8-1f7f-441a-b644-33e77b49d846');/請求urldefined('ReqURL') or define('ReqURL', 'http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx'

24、); /* * Json方式 查詢訂單物流軌跡 */function getOrderTracesByJson()$requestData= "'OrderCode':'','ShipperCode':'SF','LogisticCode':'589707398027'"$datas = array( 'EBusinessID' => EBusinessID, 'RequestType' => '1002', '

25、RequestData' => urlencode($requestData) , 'DataType' => '2', ); $datas'DataSign' = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根據公司業(yè)務處理返回的信息.return $result;/* * XML方式 查詢訂單物流軌跡 */function getOrderTracesByXml()$requestData= "<?xml version=&

26、quot;1.0" encoding="utf-8" ?>"."<Content>"."<OrderCode></OrderCode>"."<ShipperCode>SF</ShipperCode>"."<LogisticCode>589707398027</LogisticCode>"."</Content>"$datas = array( 'E

27、BusinessID' => EBusinessID, 'RequestType' => '1002', 'RequestData' => urlencode($requestData) , 'DataType' => '1', ); $datas'DataSign' = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根據公司業(yè)務處理返回的信息.return $result; /* *

28、post提交數據 * param string $url 請求Url * param array $datas 提交的數據 * return url響應返回的html */function sendPost($url, $datas) $temps = array(); foreach ($datas as $key => $value) $temps = sprintf('%s=%s', $key, $value); $post_data = implode('&', $temps); $url_info = parse_url($url);if($url_info'port'