互聯(lián)網(wǎng)的不斷發(fā)展，網(wǎng)購(gòu)如今已經(jīng)成為了人們生活的一個(gè)龐大消費(fèi)方式。足不出戶的消費(fèi)體驗(yàn)，讓越來(lái)越來(lái)多的人愛上網(wǎng)購(gòu)。網(wǎng)購(gòu)勢(shì)力的龐大，隨之帶動(dòng)的是物流行業(yè)的發(fā)展壯大。市場(chǎng)上的物流公司紛紛應(yīng)勢(shì)而生。因此對(duì)于快遞查詢對(duì)接接口的需求量也越來(lái)越大。下面以德邦快遞為例，主要講解一下，德邦快遞單號(hào)查詢接口對(duì)接教程。

德邦快遞致力成為以客戶為中心，覆蓋快速、快運(yùn)、整車、倉(cāng)儲(chǔ)與供應(yīng)鏈等多元業(yè)務(wù)的綜合性物流供應(yīng)商。堅(jiān)持以客戶為中心、以進(jìn)取者為本、以團(tuán)隊(duì)創(chuàng)高效、堅(jiān)持自我反思的核心價(jià)值觀。德邦快遞的編碼是DBL。

電商平臺(tái)、微商、小程序、ERP、WMS等需要與順豐速運(yùn)、EMS、宅急送、圓通速遞、百世快遞、中通快遞、韻達(dá)速遞、申通快遞、德邦快遞、優(yōu)速快遞、京東快遞、信豐物流、安能快遞、國(guó)通快遞、天天快遞、跨越速運(yùn)、郵政快遞包裹、中鐵快運(yùn)、郵政國(guó)內(nèi)標(biāo)快、遠(yuǎn)成快運(yùn)、全一快遞、速爾快遞、品駿快遞等多家快遞公司APi接口對(duì)接，但接口不標(biāo)準(zhǔn)，對(duì)接難度大，后期維護(hù)成本高，那么就需要找到一家可以同時(shí)連接眾多快遞公司的接口平臺(tái)。

通過(guò)快遞鳥德邦快遞單號(hào)查詢接口平臺(tái)，商家發(fā)貨后，可以實(shí)現(xiàn)軌跡查詢的實(shí)時(shí)化自動(dòng)化。根據(jù)物流軌跡自動(dòng)判斷物流狀態(tài)：如已下單、已接單、已攬件、到達(dá)派件城市、派送中、已簽收、問(wèn)題件等信息節(jié)點(diǎn)。消費(fèi)者可實(shí)時(shí)掌握訂單物流狀態(tài)。同時(shí)，可根據(jù)對(duì)應(yīng)的狀態(tài)發(fā)送短信、跟蹤訂單等操作。

【場(chǎng)景需求描述】

電商平臺(tái)及ISV商家對(duì)物流api接口的需求有很多，今天我們主要分享的就是快遞鳥快遞單號(hào)查詢接口的對(duì)接指南，快遞單號(hào)查詢接口對(duì)接的應(yīng)用場(chǎng)景有很多，很多場(chǎng)景會(huì)遇到，最主要的就是電商網(wǎng)站用戶打開“我的訂單”時(shí)調(diào)用此API顯示物流信息詳情，電商管理后臺(tái)的物流系統(tǒng)，客服在對(duì)賬前查詢所有運(yùn)單的簽收狀態(tài)，并追蹤問(wèn)題，電商平臺(tái)對(duì)商家物流管控，要求必須在多久快遞必須發(fā)出要看到攬件狀態(tài)，多久必須收到貨物看到簽收狀態(tài)，根據(jù)這些狀態(tài)對(duì)商家管控從而提高用戶的整體滿意度。

?【對(duì)接使用流程】

1、將快遞單號(hào)和快遞公司編碼發(fā)送給快遞鳥

2、快遞鳥根據(jù)單號(hào)和快遞公司查詢到物流軌跡狀態(tài)

3、快遞鳥將查詢到的物流軌跡狀態(tài)反饋給電商平臺(tái)或ISV服務(wù)商

4、電商平臺(tái)或ISV服務(wù)商接收數(shù)據(jù)并實(shí)時(shí)處理做數(shù)據(jù)展示或應(yīng)用

【接口描述說(shuō)明】

（1）查詢接口支持按照運(yùn)單號(hào)查詢(單個(gè)查詢)。

（2）接口需要指定快遞單號(hào)的快遞公司編碼，格式不對(duì)或則編碼錯(cuò)誤都會(huì)返失敗的信息。

如：EMS物流單號(hào)應(yīng)選擇快遞公司編碼（EMS）查看快遞公司編碼

（3）返回的物流跟蹤信息按照發(fā)生的時(shí)間升序排列。

（4）接口指令1002。

（5）接口支持的消息接收方式為HTTP POST，請(qǐng)求方法的編碼格式(utf-8)：

“application/x-www-form-urlencoded;charset=utf-8″。

（6）測(cè)試地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

（7）正式地址：http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

（8）免費(fèi)獲取API KEY地址：http://www.kdniao.com/reg

請(qǐng)求系統(tǒng)級(jí)參數(shù)說(shuō)明：

【接口參數(shù)】

請(qǐng)求內(nèi)容字段定義：

返回參數(shù)定義：

參數(shù)名稱 類型 說(shuō)明 必須要求

EBusinessID String 用戶ID R

OrderCode String 訂單編號(hào) O

ShipperCode String 快遞公司編碼 R

LogisticCode String 物流運(yùn)單號(hào) O

Success Bool 成功與否 R

Reason String 失敗原因 O

State String 物流狀態(tài)：2-在途中,3-簽收,4-問(wèn)題件 R

Traces

AcceptTime String 時(shí)間 R

AcceptStation String 描述 R

Remark String 備注 O

【示例】

請(qǐng)求示例 JSON

{

“OrderCode”: “”,

“ShipperCode”: “SF”,

“LogisticCode”: “118650888018”

}

返回示例 JSON

沒有物流軌跡的

{

“EBusinessID”: “1109259”,

“Traces”: [],

“OrderCode”: “”,

“ShipperCode”: “SF”,

“LogisticCode”: “118461988807”,

“Success”: false,

“Reason”: null

}

有物流軌跡的

{

“EBusinessID”: “1109259”,

“OrderCode”: “”,

“ShipperCode”: “SF”,

“LogisticCode”: “118461988807”,

“Success”: true,

“State”: 3,

“Reason”: null,

“Traces”: [

{

“AcceptTime”: “2014/06/25 08:05:37”,

“AcceptStation”: “正在派件..(派件人:鄧裕富,電話:1*********0)[深圳 市]”,

“Remark”: null

},

{

“AcceptTime”: “2014/06/25 04:01:28”,

“AcceptStation”: “快件在 深圳集散中心 ,準(zhǔn)備送往下一站 深圳 [深圳市]”,

“Remark”: null

},

{

“AcceptTime”: “2014/06/25 01:41:06”,

“AcceptStation”: “快件在 深圳集散中心 [深圳市]”,

“Remark”: null

},

{

“AcceptTime”: “2014/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”,

“AcceptStation”: “派件已簽收[深圳市]”,

“Remark”: null

},

{

“AcceptTime”: “2014/06/25 10:23:03”,

“AcceptStation”: “簽收人是：已簽收[深圳市]”,

“Remark”: null

}

]

}

【JAVA快遞單號(hào)查詢接口Demo示例】，其他Demo去快遞鳥官網(wǎng)下載

import java.io.BufferedReader;

import java.io.IOException;

import java.io.InputStreamReader;

import java.io.OutputStreamWriter;

import java.io.UnsupportedEncodingException;

import java.net.HttpURLConnection;

import java.net.URL;

import java.net.URLEncoder;

import java.security.MessageDigest;

import java.util.HashMap;

import java.util.Map;

public class KdniaoTrackQueryAPI {

//DEMO

public static void main(String[] args) {

KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();

try {

String result = api.getOrderTracesByJson(“ANE”, “210001633605”);

System.out.print(result);

} catch (Exception e) {

e.printStackTrace();

}

}

//電商ID

private String EBusinessID=”請(qǐng)到快遞鳥官網(wǎng)申請(qǐng)http://www.kdniao.com/ServiceApply.aspx”;

//電商加密私鑰，快遞鳥提供，注意保管，不要泄漏

private String AppKey=”請(qǐng)到快遞鳥官網(wǎng)申請(qǐng)http://www.kdniao.com/ServiceApply.aspx”;

//請(qǐng)求url

private String ReqURL=”http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx”;

public String getOrderTracesByJson(String expCode, String expNo) throws Exception{

String requestData= “{‘OrderCode’:”,’ShipperCode’:'” + expCode + “‘,’LogisticCode’:'” + expNo + “‘}”;

Map<String, String> params = new HashMap<String, String>();

params.put(“RequestData”, urlEncoder(requestData, “UTF-8”));

params.put(“EBusinessID”, EBusinessID);

params.put(“RequestType”, “1002”);

String dataSign=encrypt(requestData, AppKey, “UTF-8”);

params.put(“DataSign”, urlEncoder(dataSign, “UTF-8”));

params.put(“DataType”, “2”);

String result=sendPost(ReqURL, params);

//根據(jù)公司業(yè)務(wù)處理返回的信息……

return result;

}

@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 = new StringBuffer(32);

for (int i = 0; i < result.length; i++) {

int val = result[i] & 0xff;

if (val <= 0xf) {

sb.append(“0”);

}

sb.append(Integer.toHexString(val));

}

return sb.toString().toLowerCase();

}

private String base64(String str, String charset) throws UnsupportedEncodingException{

String encoded = base64Encode(str.getBytes(charset));

return encoded;

}

@SuppressWarnings(“unused”)

private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{

String result = URLEncoder.encode(str, charset);

return result;

}

@SuppressWarnings(“unused”)

private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception

{

if (keyValue != null)

{

return base64(MD5(content + keyValue, charset), charset);

}

return base64(MD5(content, charset), charset);

}

@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)求必須設(shè)置如下兩行

conn.setDoOutput(true);

conn.setDoInput(true);

// POST方法

conn.setRequestMethod(“POST”);

// 設(shè)置通用的請(qǐng)求屬性

conn.setRequestProperty(“accept”, “*/*”);

conn.setRequestProperty(“connection”, “Keep-Alive”);

conn.setRequestProperty(“user-agent”,

“Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)”);

conn.setRequestProperty(“Content-Type”, “application/x-www-form-urlencoded”);

conn.connect();

// 獲取URLConnection對(duì)象對(duì)應(yīng)的輸出流

out = new OutputStreamWriter(conn.getOutputStream(), “UTF-8”);

// 發(fā)送請(qǐng)求參數(shù)

if (params != null) {

StringBuilder param = new StringBuilder();

for (Map.Entry<String, String> entry : params.entrySet()) {

if(param.length()>0){

param.append(“&”);

}

param.append(entry.getKey());

param.append(“=”);

param.append(entry.getValue());

//System.out.println(entry.getKey()+”:”+entry.getValue());

}

//System.out.println(“param:”+param.toString());

out.write(param.toString());

}

// flush輸出流的緩沖

out.flush();

// 定義BufferedReader輸入流來(lái)讀取URL的響應(yīng)

in = new BufferedReader(

new InputStreamReader(conn.getInputStream(), “UTF-8”));

String line;

while ((line = in.readLine()) != null) {

result.append(line);

}

} catch (Exception e) {

e.printStackTrace();

}

//使用finally塊來(lái)關(guān)閉輸出流、輸入流

finally{

try{

if(out!=null){

out.close();

}

if(in!=null){

in.close();

}

}

catch(IOException ex){

ex.printStackTrace();

}

}

return result.toString();

}

private static char[] base64EncodeChars = new char[] {

‘A’, ‘B’, ‘C’, ‘D’, ‘E’, ‘F’, ‘G’, ‘H’,

‘I’, ‘J’, ‘K’, ‘L’, ‘M’, ‘N’, ‘O’, ‘P’,

‘Q’, ‘R’, ‘S’, ‘T’, ‘U’, ‘V’, ‘W’, ‘X’,

‘Y’, ‘Z’, ‘a’, ‘b’, ‘c’, ‘d’, ‘e’, ‘f’,

‘g’, ‘h’, ‘i’, ‘j’, ‘k’, ‘l’, ‘m’, ‘n’,

‘o’, ‘p’, ‘q’, ‘r’, ‘s’, ‘t’, ‘u’, ‘v’,

‘w’, ‘x’, ‘y’, ‘z’, ‘0’, ‘1’, ‘2’, ‘3’,

‘4’, ‘5’, ‘6’, ‘7’, ‘8’, ‘9’, ‘+’, ‘/’ };

public static String base64Encode(byte[] data) {

StringBuffer sb = new StringBuffer();

int len = data.length;

int i = 0;

int b1, b2, b3;

while (i < len) {

b1 = data[i++] & 0xff;

if (i == len)

{

sb.append(base64EncodeChars[b1 >>> 2]);

sb.append(base64EncodeChars[(b1 & 0x3) << 4]);

sb.append(“==”);

break;

}

b2 = data[i++] & 0xff;

if (i == len)

{

sb.append(base64EncodeChars[b1 >>> 2]);

sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);

sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);

sb.append(“=”);

break;

}

b3 = data[i++] & 0xff;

sb.append(base64EncodeChars[b1 >>> 2]);

sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);

sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]);

sb.append(base64EncodeChars[b3 & 0x3f]);

}

return sb.toString();

}

}