免費(fèi)快遞接口api

1、免費(fèi)快遞接口api接口地址：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx支持格式：json 請(qǐng)求方式：HTTP POST接口平臺(tái)：快遞鳥免費(fèi)查詢接口 請(qǐng)求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。順豐快遞接口api申請(qǐng)JSON請(qǐng)求/返回示例：1.請(qǐng)求       "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": "快件在 深圳集散中心 ,準(zhǔn)備送往下一站 深圳 深圳市", "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": "快件在 深圳 ,準(zhǔn)備送往下一站 深圳集散中心 深圳市", "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）、支持的數(shù)據(jù)傳輸格式 Json/Xml(暫不支持<content/>這種形式)。 編碼格式：UTF-8 交互

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

9、物流技術(shù)接口提供調(diào)用物流接口的DEMO(.Net版本)，包括網(wǎng)上在線訂單下單、物流軌跡查詢等物流行業(yè)標(biāo)準(zhǔn)化的下單操作流程與數(shù)據(jù)查詢格式。提交接入處理的相關(guān)代碼如有不明白的地方可與物流技術(shù)接口人協(xié)作開發(fā)。DEMO下載地址： 4）、接口數(shù)據(jù)包結(jié)構(gòu)圖例 - 數(shù)據(jù)包結(jié)構(gòu) (系統(tǒng)級(jí)數(shù)據(jù))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" /請(qǐng)求地址 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");/生成加密簽名加密通過對(duì)參數(shù)xmlStr+ keyValue

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

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

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

15、： <Content><ShipperCode>SF</ShipperCode><LogisticCode>118954907573</LogisticCode></Content>，經(jīng)過URL(UTF-8)編碼的內(nèi)容為%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簽名的內(nèi)容為<Content><ShipperCode>SF</ShipperCode><LogisticCode>118954907573</LogisticCode></Content>56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17，經(jīng)過md5和base64后的內(nèi)容就為YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE=，在經(jīng)過URL(UTF-8)編碼的內(nèi)容為YzBjOD

17、A3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE%3d(c) 最終要發(fā)送的數(shù)據(jù)為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) 接收方收到數(shù)據(jù)后，獲得EBusinessID 和RequestData和DataSign等這幾個(gè)數(shù)據(jù)。(e) 接收方對(duì)EBusinessID 得到AppKey，RequestData+AppKey的數(shù)據(jù)進(jìn)行md5和base64后的內(nèi)容就為YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE=(f) 接收方判斷簽名后的數(shù)據(jù)跟傳遞過來的DataSign是否一致，如果一致進(jìn)行業(yè)務(wù)操作，如果不一直返回錯(cuò)誤。9）、(C#)DataSign簽名加密代碼/<summary>/電商Sign簽名/</summary>/<p

19、aram name="content">內(nèi)容</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');/請(qǐng)求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);/根據(jù)公司業(yè)務(wù)處理返回的信息.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);/根據(jù)公司業(yè)務(wù)處理返回的信息.return $result; /* *

28、post提交數(shù)據(jù) * param string $url 請(qǐng)求Url * param array $datas 提交的數(shù)據(jù) * return url響應(yīng)返回的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'