2. 程式人生 > >快遞物流查詢介面介紹

快遞物流查詢介面介紹

阿新 • • 發佈：2019-02-19

快遞查詢介面API    

快遞查詢介面是指快遞查詢網對外開放的應用程式介面，開發人員能夠通過呼叫該介面與快遞查詢網進行互動，並基於該介面開發自己的快遞查詢應用程式。目前比較常用的介面有快遞鳥、快遞100、快遞網等。

應用場景


        電商網站使用者開啟“我的訂單”時呼叫此API顯示物流資訊詳情；或者是電商管理後臺的物流系統，客服在對賬前查詢所有運單的簽收狀態，並追蹤問題。

快遞查詢介面分類

        物流軌跡查詢介面有即時查詢和訂閱查詢兩種，即時是請求即返回資料，訂閱則是訂閱快遞單號到介面，有物流軌跡更新則全量返回資料。

        快遞鳥即時介面可以查詢3000次，3000以上接訂閱介面，統一介面模式接入，常用快遞均支援查詢，還有訂閱介面、線上下單介面、電子面單介面，介面均不收取費用，        沒有要求使用者新增外鏈，支援418家國內外快遞物流查詢。

        快遞100每天可以免費查詢2000次，超過2000次收費，每次0.06~0.1元不等，如果查詢的量大的話可以降低費用，免費的介面有幾家常用快遞不支援介面模式，只支援   htmlAPI，要求使用者新增外鏈，支援300多家國內外快遞物流查詢。

        快遞網每天可以免費查詢500次，超過500次收費，每次0.05元，只有即時查詢和訂閱推送介面，要求使用者新增外鏈，支援395家國內外快遞物流查詢。

對接說明

         KEY和ID，如果是訂閱介面需要技術聯調。以快遞鳥及時查詢介面接入為例。

      根據快遞單號和快遞公司編碼查詢物流軌跡資訊。介面需要指定快遞單號的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的資訊。如：EMS物流單號應選擇快遞公司編碼（EMS）

檢視快遞公司編碼返回的物流跟蹤資訊按照發生的時間升序排列。

        介面支援的訊息接收方式為HTTP POST

        請求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"

        API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

請求系統級引數

引數名稱 型別 說明 必須要求
RequestData String 請求內容需進行URL(utf-8)編碼。請求內容JSON或XML格式，須和DataType一致。 R
EBusinessID
 String 商戶ID，請在我的服務頁面檢視。 R
RequestType String 請求指令型別：1002 R
DataSign String 資料內容簽名：把(請求內容(未編碼)+AppKey)進行MD5加密，然後Base64編碼，最後進行URL(utf-8)編碼。詳細過程請檢視Demo。 R
DataType String 請求、返回資料型別：1-xml,2-json；預設為xml格式 O

請求內容欄位定義

引數 型別 說明 必須要求
OrderCode String 訂單編號 O
ShipperCode String 快遞公司編碼 R
LogisticCode String 物流單號 R

返回引數定義

引數名稱 型別 說明 必須要求
EBusinessID String 使用者ID R
OrderCode String 訂單編號 O
ShipperCode String 快遞公司編碼 R
LogisticCode String 物流運單號 R
Success Bool 成功與否 R
Reason String 失敗原因 O
State String 物流狀態：2-在途中,3-簽收,4-問題件 R
Traces
Trace AcceptTime String 時間 R
AcceptStation String 描述 R
Remark String 備註 O

Java呼叫示例

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import 

java.io.OutputStreamWriter;
import 

java.io.UnsupportedEncodingExcept

ion;
import 

java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import 

java.security.MessageDigest;
import java.util.HashMap;
import java.util.Map; 

/**
 *
 * 快遞鳥物流軌跡即時查詢介面
 *
 * @技術QQ群: 456320272
 * @see: 

http://www.kdniao.com/YundanChaxu

nAPI.aspx
 * @copyright: 深圳市快金資料技術

服務有限公司
 *
 * DEMO中的電商ID與私鑰僅限測試使

用，正式環境請單獨註冊賬號
 * 單日超過500單查詢量，建議接入

我方物流軌跡訂閱推送介面
 * 
 * ID和Key請到官網申請：

http://www.kdniao.com/ServiceAppl

y.aspx
 */

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="請到快遞鳥官網申請

http://www.kdniao.com/ServiceAppl

y.aspx";
	//電商加密私鑰，快遞鳥提

供，注意保管，不要洩漏
	private String AppKey="請

到快遞鳥官網申請

http://www.kdniao.com/ServiceAppl

y.aspx";
	//請求url
	private String 

ReqURL="http://api.kdniao.cc/Ebus

iness/EbusinessOrderHandle.aspx";	
 
	/**
     * Json方式 查詢訂單物流軌跡
	 * @throws Exception 
     */
	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);	
		
		//根據公司業務處

理返回的資訊......
		
		return result;
	}
	
	/**
     * XML方式 查詢訂單物流軌跡
	 * @throws Exception 
     */
	public String 

getOrderTracesByXml() throws 

Exception{
		String 

requestData= "<?xml version=

\"1.0\" encoding=\"utf-8\" ?>"+
					

		"<Content>"+
					

		

"<OrderCode></OrderCode>"+
					

		

"<ShipperCode>SF</ShipperCode>"+
					

		

"<LogisticCode>589707398027</Logi

sticCode>"+
					

		"</Content>";
		
		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", "1");
		
		String 

result=sendPost(ReqURL, params);	
		
		//根據公司業務處

理返回的資訊......
		
		return result;
	}
 
	/**
     * MD5加密
     * @param str 內容       
     * @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 = 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();
	}
	
	/**
     * base64編碼
     * @param str 內容       
     * @param charset 編碼方式
	 * @throws 

UnsupportedEncodingException 
     */
	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;
	}
	
	/**
     * 電商Sign簽名生成
     * @param content 內容   
     * @param keyValue Appkey  
     * @param charset 編碼方式
	 * @throws 

UnsupportedEncodingException 

,Exception
	 * @return DataSign簽名
     */
	@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);
	}
	
	 /**
     * 向指定 URL 傳送POST方法的

請求     
     * @param url 傳送請求的 URL  

  
     * @param params 請求的引數集

合     
     * @return 遠端資源的響應結果
     */
	@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();
            // 傳送POST請求必須設

置如下兩行
            conn.setDoOutput

(true);
            conn.setDoInput

(true);
            // POST方法
            

conn.setRequestMethod("POST");
            // 設定通用的請求屬性
            

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

物件對應的輸出流
            out = new 

OutputStreamWriter

(conn.getOutputStream(), "UTF-

8");
            // 傳送請求引數       

     
            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

輸入流來讀取URL的響應
            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塊來關閉輸出

流、輸入流
        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(); 
    }
}


相關推薦

快遞物流查詢介面介紹

快遞查詢介面API     快遞查詢介面是指快遞查詢網對外開放的應用程式介面，開發人員能夠通過呼叫該介面與快遞查詢網進行互動，並基於該介面開發自己的快遞查詢應用程式。目前比較常用的介面有快遞鳥、快遞100、快遞網等。 應用場景         電商網站使用者開啟“我的訂

Java快遞物流查詢介面，怎麼接入物流介面API，如何根據單號查詢物流跟蹤的詳細資訊的Demo詳細說明

Java怎麼寫物流介面，怎麼接入物流介面，如何根據單號查詢物流跟蹤的詳細資訊 實現需求： 根據使用者輸入的訂單號，我們的後臺識別訂單號並根據快遞鳥查詢快遞Api介面，實現自動查詢的功能 應用場景 實現的具體步驟 　１.本介面採用 快遞鳥物流介

快遞物流查詢介面API，使用Jquery的ajax跨域實現根據單號查詢物流跟蹤的詳細資訊

應用場景：物流跟蹤資訊查詢 1. 本介面採用的是聚合資料介面：https://www.juhe.cn/docs/api/id/43 2. 首先，註冊賬號申請快遞單號介面：獲取申請的key 3. 介面所需引數檢視（主要是這三個需要傳到服務端）https://w

JavaWeb實現快遞物流查詢

網上的物流查詢介面有很多，但是大部分都比較麻煩。所以這裡介紹一個比較簡單的查詢方法，不需要註冊，只需要快遞單號和物流公司就可以的檢視物流資訊了。 介面連結 主要是利用 快遞100 的查詢網址： http://www.kuaidi100.com/query?type=快遞公司英文&

快遞查詢介面 - 實時快速獲取物流進度資訊

接上篇 實時獲取淘寶天貓商品的評價晒單資料，這裡則是基於訂單的物流單號，呼叫介面獲取物流進度，介面資訊： 請求地址：https://taoapi.ndxiu.com/service/get_logis.php 請求方式：get 請求示例：{id:'物流單號',appkey:'專屬appkey'

免費快遞物流軌跡資訊查詢介面API對接方法

    物流軌跡查詢-使用的物流單號和快遞單號即可實現查詢物流資訊。     目前提供的快遞查詢介面有免費版和收費版，目前比較常用的是菜鳥和快遞鳥介面。 快遞鳥介面免費不限量對接 介面規則 (1)、查詢介面支援按照運單號查詢(單個查詢，併發不超過10個/S)。 (2)、指

常用物流快遞單號查詢介面種類及對接方法

目前快遞查詢介面有兩種方式可以對接，一是和順豐、圓通、中通、天天、韻達、德邦這些快遞公司一一對接介面，二是和快遞鳥這樣第三方整合介

PHP如何免費對接呼叫快遞物流單號查詢api介面

博主最近需要做一個物流資訊軌跡查詢的api介面，就去網上搜索，看到了一個快遞鳥的API介面，返回值是以JSON格式，只需要返回是轉

快遞鳥查詢Api介面使用（PHP版）

前提 專案開發中，有些需求難免會用到關於快遞的一些Api介面；本篇主要介紹的是快遞的查詢Api及與其他各家的不同之處； 常用的提供快遞Api介面的有: 快遞鳥 快遞100 愛查快遞 等等

物流資訊查詢介面

啥都不說，分享給大家，在網上找到的一個免費的物流資訊查詢介面。 請求方式:get @param String type 物流公司簡寫。如yunda String code 物流單號 http://www.kuaidi100.com/query?type={TYPE}&p

kuai100物流資訊查詢介面

可以自定義物流列舉： /*** * @Description 自定義列舉 */ public enum LogisticsCompany { SF("順豐", 1, "shunfeng"

通過微信，python實現一鍵查詢天氣+火車票+飛機票+快遞物流！

  前言： 今天我們來進一步地實現更高階點的功能——查天氣+火車+飛機+快遞！！！當，這裡只是把他們集中在一起了，通過微信itchat的自動回覆功能，實現回覆關鍵字，返回自動查詢結果的效果！ 學習Python中有不明白推薦加入交流群    

快遞鳥免費物流查詢API-雙十一大促的使用者體驗

第十一期沙龍      京東物流高階經理——應康興，征戰物流領域5年，電商圈履新3載，京東物流全國銷售工作負責人，曾先後服務Dell、HP、Vivo、羅輯思維、PUMA、匡威、李寧等客戶，專注提供倉配一體供應鏈解決方案。 Harry-JD配送-高階經理(311573154

SHOPEX快遞物流單號查詢插件

ftp 好的 view apply 有效 擴展 後臺 數據 exp 　　本SHOPEX快遞物流單號跟蹤插件提供國內外近2000家快遞物流訂單單號查詢服務例如申通快遞、順豐快遞、圓通快遞、EMS快遞、匯通快遞、宅急送快遞、德邦物流、百世快遞、匯通快遞、中通快遞、天天快遞等知名

查詢快遞免費api介面（PHP示例）

電商企業、微商使用者和ERP可以使用集中快遞查詢API介面獲取快遞物流資訊，相比於分別對接快遞公司介面，這種集中查詢介面的優勢是，減少對接難度，以及降低了介面維護難度。一、快遞查件介面快遞查件，有不少公司提供這種集中查件介面，比如：快遞100快遞100每天可查詢兩千次，當日查

PHP規範PSR16(快取庫的通用介面)介紹

本文件描述了快取項和快取驅動程式的簡單但可擴充套件的介面。 本文件中的關鍵詞“必須”，“必須”，“必需”，“應該”，“不應該”，“應該”，“不應該”，“推薦”，“可以”和“可選”按照RFC 2119中的描述進行解釋。 最終的實現可以使用比提出的功能更多的功能來裝飾物件，但是它們必須首先實現所

“雙十一”即將來臨，先來看看快遞物流企業的大資料

繼中通、韻達後，圓通速遞於日前宣佈漲價。據悉，圓通速遞將對全國各網點到達上海地區的快件派送費上調，上調幅度為0.5元/票。雙十一臨近，快遞企業接連漲價，行業或將迎來集體漲價潮。 據圓通速遞稱，此次調價行為是為保障服務質量和末端派送，並綜合考慮成本上升、環境因素等影響而上調的。此前，中通、韻達也陸

下劃線命名轉換為駝峰命名（根據介面名查詢介面檔名）

見到一段程式碼實現的功能是：通過介面名驗證介面檔案是否存在。 舉個例子：介面名為：aa_bb_cc 介面檔名為 AbcAaBbCc.php 取這段程式碼稍作改造： <?php class FindFilename { /** $prefix 檔案字首 $Interfa

迅為iMX6UL Cortex-A7架構單核ARM開發板介面介紹-支援定製

支援商業級和工業級核心板          1. POWER 電源介面電源輸入為 5V/2A+,給核心板提供 5V 電源，給底板供電。原理圖部分如下圖所示。          電

佇列 Queue介面介紹

add方法 //將一個非空非null元素插入到該佇列，如果插入成功返回true,不成功丟擲異常 boolean add(E e); offer方法 //將一個非空非null元素插入到該佇列，如果插入成功返回true,不成功返回false boolean offer(E e);