不限量免費(fèi)快遞查詢API-JAVA對(duì)接文檔

1、不限量免費(fèi)快遞查詢API-JAVA對(duì)接文檔1.1 接口規(guī)則 (1)、客戶服務(wù)器必須穩(wěn)定，并且有一定的接受數(shù)據(jù)能力。接口通過(guò)多線程推送物流信息給客戶。 (2)、客戶需要按要求開(kāi)發(fā)接口，保證信息的正常接收?？蛻艚訑?shù)據(jù)后，存儲(chǔ)并馬上返回接收響應(yīng)。如果客戶對(duì)數(shù)據(jù)進(jìn)行處理，再做出響應(yīng)。這會(huì)造成網(wǎng)絡(luò)超時(shí)，傳輸效率低下。(3)、主動(dòng)推送時(shí)物流信息接收接口由客戶提供，接口必須按照要求實(shí)現(xiàn)。(4)、接口提供：快遞鳥 (5)、在快遞鳥接口調(diào)試平臺(tái)輸入回調(diào)地址。 (6)、接口只支持Json數(shù)據(jù)格式。 (7)、POS方式請(qǐng)求。1.2 系統(tǒng)級(jí)輸入?yún)?shù)參數(shù)名稱類型必須要求說(shuō)明RequestDataStringR推送數(shù)據(jù)經(jīng)

2、url轉(zhuǎn)碼utf-8 RequestTypeStringR101-軌跡查詢結(jié)果, 107-貨款狀態(tài)1.3 應(yīng)用級(jí)輸入?yún)?shù)參數(shù)名稱類型必須要求說(shuō)明EBusinessIDStringR用戶電商IDPushTimeStringR推送時(shí)間CountStringR推送物流單號(hào)軌跡個(gè)數(shù)DataStringR推送物流單號(hào)軌跡集合1.3.1 訂閱查詢結(jié)果（RequestType：101）通過(guò)軌跡查詢（訂閱查詢）接口訂閱到快遞鳥的數(shù)據(jù)，快遞鳥推送時(shí)，會(huì)將推送的RequestType的值置為101，同時(shí)返回下列數(shù)據(jù)參數(shù)名稱類型必須要求說(shuō)明ResponseEBusinessIDStringO電商用戶IDOrderC

3、odeStringO訂單編號(hào)ShipperCodeStringR快遞公司編碼LogisticCodeStringR物流運(yùn)單號(hào)SuccessBoolR成功與否ReasonStringO失敗原因StateStringR物流狀態(tài):0-無(wú)軌跡1-已攬收2-在途中201-到達(dá)派件城市3-簽收4-問(wèn)題件CallBackStringO訂閱接口的Bk值TracesStringR物流軌跡詳情EstimatedDeliveryTimeStringO預(yù)計(jì)到達(dá)時(shí)間yyyy-mm-ddPickerInfoObjectO收件員信息SenderInfoObjectO派件員信息注：通過(guò)訂單分發(fā)與電子面單接口自動(dòng)訂閱的運(yùn)單，會(huì)

4、返回預(yù)計(jì)達(dá)到時(shí)間,收派件人員網(wǎng)點(diǎn)信息,當(dāng)前快件所在省市等字段參數(shù)名稱類型必須要求說(shuō)明TracesAcceptTimeStringR時(shí)間AcceptStationStringR描述RemarkStringO備注參數(shù)名稱類型必須要求說(shuō)明PickerInfoPersonNameStringO快遞員姓名PersonTelStringO快遞員電話PersonCodeStringO快遞員工號(hào)StationNameStringO網(wǎng)點(diǎn)名稱StationAddressStringO網(wǎng)點(diǎn)地址StationTelStringO網(wǎng)點(diǎn)電話參數(shù)名稱類型必須要求說(shuō)明SenderInfoPersonNameStringO派件

5、快遞員姓名PersonTelStringO派件快遞員電話PersonCodeStringO派件快遞員工號(hào)StationNameStringO派件網(wǎng)點(diǎn)名稱StationAddressStringO派件網(wǎng)點(diǎn)地址StationTelStringO派件網(wǎng)點(diǎn)電話1.3.2 貨款狀態(tài)（RequestType：107）用戶通過(guò)電子面單使用貨到付款等金融服務(wù)時(shí)，快遞鳥會(huì)將該訂單的金融狀態(tài)通過(guò)接口推送給用戶。參數(shù)名稱類型必須要求說(shuō)明ResponseEBusinessIDStringO電商用戶IDOrderCodeStringO訂單編號(hào)ShipperCodeStringR快遞公司編碼LogisticCodeStr

6、ingR物流運(yùn)單號(hào)SuccessBoolR成功與否ReasonStringO失敗原因StateStringR物流狀態(tài):0-無(wú)軌跡1-已攬收2-在途中201-到達(dá)派件城市3-簽收4-問(wèn)題件CallBackStringO訂閱接口的Bk值OrderStateStringO訂單貨款狀態(tài)：1-待出款；2-已出款；3-已收款A(yù)ccountNameStringO返款銀行卡開(kāi)戶人（例：*偉、*佳）AccountTelStringO返款銀行卡手機(jī)末四位AccountNumStringO返款銀行卡末四位注：通過(guò)訂單分發(fā)與電子面單接口自動(dòng)訂閱的運(yùn)單，會(huì)返回預(yù)計(jì)達(dá)到時(shí)間,收派件人員網(wǎng)點(diǎn)信息,當(dāng)前快件所在省市等字段1.

7、4 返回結(jié)果參數(shù)參數(shù)名稱類型必須要求說(shuō)明EBusinessIDStringR用戶IDUpdateTimeStringR時(shí)間SuccessStringR成功與否ReasonStringO失敗原因1.5 JSON請(qǐng)求示例訂閱查詢結(jié)果示例： "EBusinessID": "1109259", "Count": "2", "PushTime": "2015-03-11 16:21:06", "Data": "EBusinessID": &quo

8、t;1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908504", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "Traces":

9、 "AcceptTime": "2015-03-06 21:16:58", "AcceptStation": "深圳市橫崗速遞營(yíng)銷部已收件，（攬投員姓名：鐘定基;聯(lián)系電話：）", "Remark": "" , "AcceptTime": "2015-03-07 14:25:00", "AcceptStation": "離開(kāi)深圳市 發(fā)往廣州市", "Remark": "

10、" , "AcceptTime": "2015-03-08 00:17:00", "AcceptStation": "到達(dá)廣東速遞物流公司廣航中心處理中心（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-08 01:15:00", "AcceptStation": "離開(kāi)廣州市 發(fā)往北京市（經(jīng)轉(zhuǎn)）", "Remark": &qu

11、ot;" , "AcceptTime": "2015-03-09 09:01:00", "AcceptStation": "到達(dá)北京黃村轉(zhuǎn)運(yùn)站處理中心（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-09 18:39:00", "AcceptStation": "離開(kāi)北京市 發(fā)往呼和浩特市（經(jīng)轉(zhuǎn)）", "Remark": &qu

12、ot;" , "AcceptTime": "2015-03-10 18:06:00", "AcceptStation": "到達(dá) 呼和浩特市 處理中心", "Remark": "" , "AcceptTime": "2015-03-11 09:53:48", "AcceptStation": "呼和浩特市郵政速遞物流分公司金川攬投部安排投遞（投遞員姓名：安長(zhǎng)虹;聯(lián)系電話&

13、quot;, "Remark": "" , "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260943004", "Success": true, "Reason": "", "State":

14、"2", "CallBack": "0", "Traces": "AcceptTime": "2015-03-07 15:26:09", "AcceptStation": "深圳市橫崗速遞營(yíng)銷部已收件，（攬投員姓名：周宏彪;聯(lián)系電話", "Remark": "" , "AcceptTime": "2015-03-08 16:32:00&quo

15、t;, "AcceptStation": "離開(kāi)深圳市 發(fā)往廣州市", "Remark": "" , "AcceptTime": "2015-03-09 00:58:00", "AcceptStation": "到達(dá)廣東速遞物流公司廣航中心處理中心（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-09 01:15:00"

16、;, "AcceptStation": "離開(kāi)廣州市 發(fā)往北京市（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-10 05:20:00", "AcceptStation": "到達(dá)北京黃村轉(zhuǎn)運(yùn)站處理中心（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-10 11:59:00",

17、 "AcceptStation": "離開(kāi)北京市 發(fā)往廊坊市（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-10 14:23:00", "AcceptStation": "到達(dá)廊坊市處理中心（經(jīng)轉(zhuǎn)）", "Remark": "" , "AcceptTime": "2015-03-11 08:55:00", "

18、;AcceptStation": "離開(kāi)廊坊市 發(fā)往保定市（經(jīng)轉(zhuǎn)）", "Remark": "" 貨款狀態(tài)：    "EBusinessID": "1109259",    "Count": "2",    "PushTime": "2015/3/11 16:21:06",    &quo

19、t;Data":                     "EBusinessID": "1109259",            "OrderCode": "",    

20、0;       "ShipperCode": "EMS",            "LogisticCode": "5042260908504",            "Success": true, &#

21、160;          "Reason": "",            "State": "2",            "CallBack": "0", 

22、;           "OrderState":"1",            "AccountName":"張三",            "AccountTel":"

23、quot;,            "AccountNum":"0321"        ,                    "EBusinessID&quo

24、t;: "1109259",            "OrderCode": "",            "ShipperCode": "EMS",           

25、; "LogisticCode": "5042260908522",            "Success": true,            "Reason": "",         

26、;   "State": "2",            "CallBack": "0",            "OrderState":"1",       

27、0;    "AccountName":"張三",            "AccountTel":"quot;,            "AccountNum":"0321"   &#

28、160;        1.6 JSON返回示例 "EBusinessID": "1109259", "UpdateTime": "2015-03-11 16: 26: 11", "Success": true, "Reason": ""1.7 JAVA對(duì)接代碼import java.io.BufferedReader;import java.io.IOException; import java

29、.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import ernal.impl.dv.util.Base64;import java.security.MessageDigest;

30、 public class KdGoldAPIDemo /電商IDprivate String EBusinessID="1237100"/電商加密私鑰，注意保管，不要泄漏，請(qǐng)重新申請(qǐng)秘鑰private String AppKey="518a73d8-1f7f-441a-b644-33e77b49d846"/請(qǐng)求urlprivate String ReqURL="http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx" /* * Json方式 物流信息訂閱 * throws Ex

31、ception */public String orderTracesSubByJson() throws ExceptionString requestData="'Code': 'SF','Item': "+ "'No': '909261024507','Bk': 'test',"+ "'No': '589554393102','Bk': 'test',"+

32、 "'No': '589522101958','Bk': 'test',"+ "'No': '909198822942', 'Bk': 'test'"+ ""Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestDa

33、ta, "UTF-8");params.put("EBusinessID", EBusinessID);params.put("RequestType", "1005");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8");params.put("DataType", &quo

34、t;2");String result=sendPost(ReqURL, params);/根據(jù)公司業(yè)務(wù)處理返回的信息.return result;/* * XML方式 物流信息訂閱 * throws Exception */public String orderTracesSubByXml() throws ExceptionString requestData="<?xml version="1.0" encoding="utf-8" ?>"+"<Content>"+"

35、;<Code>SF</Code>"+"<Items>"+"<Item>"+"<No>909261024507</No>"+"<Bk>test</Bk>"+"</Item>"+"<Item>"+"<No>909261024507</No>"+"<Bk>test</Bk>&q

36、uot;+"</Item>"+"</Items>"+"</Content>"Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8");params.put("EBusinessID", EBusinessID);params.put(&quo

37、t;RequestType", "1005");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8");params.put("DataType", "1");String result=sendPost(ReqURL, params);/根據(jù)公司業(yè)務(wù)處理返回的信息.return result;/* * MD5

38、加密 * param str 內(nèi)容 * param charset 編碼方式 * throws Exception */SuppressWarnings("unused")private String MD5(String str, String charset) throws Exception MessageDigest md = MessageDigest.getInstance("MD5"); md.update(str.getBytes(charset); byte result = md.digest(); StringBuffer sb =

39、 new StringBuffer(32); for (int i = 0; i < result.length; i+) int val = resulti & 0xff; if (val <= 0xf) sb.append("0"); sb.append(Integer.toHexString(val); return sb.toString().toLowerCase();/* * base64編碼 * param str 內(nèi)容 * param charset 編碼方式 * throws UnsupportedEncodingException *

40、/private String base64(String str, String charset) throws UnsupportedEncodingExceptionString encoded = Base64.encode(str.getBytes(charset);return encoded; SuppressWarnings("unused")private String urlEncoder(String str, String charset) throws UnsupportedEncodingExceptionString result = URLE

41、ncoder.encode(str, charset);return result;/* * 電商Sign簽名生成 * param content 內(nèi)容 * param keyValue Appkey * param charset 編碼方式 * throws UnsupportedEncodingException ,Exception * return DataSign簽名 */SuppressWarnings("unused")private String encrypt (String content, String keyValue, String charset

42、) throws UnsupportedEncodingException, Exceptionif (keyValue != null)return base64(MD5(content + keyValue, charset), charset);return base64(MD5(content, charset), charset); /* * 向指定 URL 發(fā)送POST方法的請(qǐng)求 * param url 發(fā)送請(qǐng)求的 URL * param params 請(qǐng)求的參數(shù)集合 * return 遠(yuǎn)程資源的響應(yīng)結(jié)果 */SuppressWarnings("unused")private String sendPost(String url, Map<String, String> params) OutputStreamWriter out = null; BufferedReader in = null; StringBuilder result = new StringBuilder(); try URL realUrl = new URL(url); HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection(); / 發(fā)送POST請(qǐng)