1. 程式人生 > >快遞單號查詢免費api接口(PHP示例)

快遞單號查詢免費api接口(PHP示例)

rpo 快遞 生成 pytho 流水號 omr pla 處理 購物

快遞單號查詢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示例)