快遞單號查詢免費api介面（PHP樣本）

標籤：http post   編碼   contex   des   PHP代碼   java   header   查詢   express   

快遞單號查詢API，可以對接順豐快遞查詢，郵政快遞查詢，中通快遞查詢等。這些快遞物流企業，提供了快遞單號自動識別介面，快遞單號查詢介面等快遞物流服務。對於電商企業，ERP服務企業，整合此介面到自己的軟體中，增加了企業的競爭力。但是有個缺點，需要分別對接到各大快遞公司，分別調試介面，維護成本高，不方便管理等。推薦一個提供快遞查詢api免費對接的服務平台，快寶開放平台。

一、介面應用情境

1.在電商平台購物後，通過購物訂單跟蹤物流時，調用此API擷取物流資訊詳情

2.處理運費對賬時，一鍵擷取運單物流狀態

3.批量跟蹤及擷取運單物流資訊

 

二、對接準備

1.註冊快寶開放平台，登入位址：http://open.kuaidihelp.com/register

2.擷取開發人員帳號資訊（ID ,API Key），在【控制台】中查看

3.進行技術聯調，並完成調試，物流查詢api地址：http://open.kuaidihelp.com/api/1003

4.在您的軟體中整合快遞物流查詢介面

 

三、技術對接

快寶開放平台提供的快遞查詢介面，支援110多家快遞物流查詢，涵蓋了國內主流快遞服務企業的單號查詢，資訊及時，資料完整。

介面名稱：express.info.get
正式地址：https://kop.kuaidihelp.com/api
請求方式：HTTP POST
要求方法編碼格式：utf-8

公用請求參數 ↓ 

名稱	類型	是否必須	描述
method	string	是	API介面名稱
app_id	string	是	使用者ID（註冊開放平台時分配，在控制台中查看）
sign	string	是	按照規則(md5(app_id + method + ts + api_key))產生的驗證合法性簽名
ts	string	是	當前請求的時間戳記
data	string	是	JSON格式請求參數設定

公用響應參數  ↓  

名稱	類型	是否必須	描述
code	int	是	響應狀態代碼。0-成功，非0-失敗下載並查看詳情
msg	string	是	返回結果說明
uid	string	是	本次請求唯一業務流水號
data	string	是	JSON格式響應資料

 

請求參數  ↓  

名稱	類型	是否必輸	描述
waybill_no	string	是	物流單號，多個單號之間用","隔開,最多支援10條
exp_company_code	string	是	支援品牌簡稱請查看品牌列表下載並查看詳情

 

 

 

 

響應參數  ↓

名稱	類型	是否必須	描述
code	int	是	響應狀態代碼。0-成功，非0-失敗
msg	string	是	返回結果說明
data	string	是	JSON格式響應資料

請求程式碼範例  ↓

支援6中開發語言對接，包括JAVA，C#，PHP，Python，Node.js，Crul；根據您的開發語言，選擇參考對應的程式碼範例，下面以PHP代碼為例：

 1 $host = "https://kop.kuaidihelp.com/api"; 2 $method = "POST"; 3 $headers = array(); 4 //根據API的要求，定義相對應的Content-Type 5 array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8"); 6 $querys = ""; 7 $bodys = [ 8 "app_id"=>‘50001‘, 9 "method"=>‘express.info.get‘,10 "sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",11 "ts"=>‘1524209949‘,12 "data"=>‘{ "waybill_no":"物流單號多個的以英文逗號分隔", "exp_company_code":"品牌簡稱"}‘13 ];14 $bodys = http_build_query($bodys);15 $url = $host;16 $curl = curl_init();17 curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);18 curl_setopt($curl, CURLOPT_URL, $url);19 curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);20 curl_setopt($curl, CURLOPT_FAILONERROR, false);21 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);22 curl_setopt($curl, CURLOPT_HEADER, true);23 if (1 == strpos("$".$host, "https://"))24 {25     curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);26     curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);27 }28 curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);29 var_dump(curl_exec($curl));

成功響應樣本 ↓  

響應（成功、失敗）樣本，僅支援JSON格式。

 1 { 2 "code":int0 3 "msg":string"查詢成功" 4 "data":[ 5 0:{ 6 "no":string"3339809700595" 7 "brand":string"sto" 8 "status":string"signed" 9 "data":[10 0:{11 "time":string"2017-10-03 19:11:00"12 "context":string"已簽收,簽收人是代簽"13 }14 1:{15 "time":string"2017-10-03 08:14:33"16 "context":string"快件已到達 浙江浦江公司"17 }18 2:{19 "time":string"2017-10-03 01:09:41"20 "context":string"由浙江義烏中轉部 發往 浙江浦江公司"21 }22 ]23 "order":string"desc"24 }25 ]26 }

失敗響應樣本  ↓  

1 {2 "code":string"錯誤碼"3 "msg":string"錯誤資訊"4 "data":{}5 }

錯誤碼

錯誤碼	描述
201102	請求參數錯誤
201103	不支援的快遞品牌
201101	查詢暫無記錄

 

- the end -

快遞單號查詢免費api介面（PHP樣本）