快遞單號查詢免費api接口（PHP示例）

快遞單號查詢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代碼為例：

$host = "https://kop.kuaidihelp.com/api";
$method = "POST";
$headers = array();
//根據API的要求，定義相對應的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = [
"app_id"=>'50001',
"method"=>'express.info.get',
"sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",
"ts"=>'1524209949',
"data"=>'{ "waybill_no":"物流單號多個的以英文逗號分隔", "exp_company_code":"品牌簡稱"}'
];
$bodys = http_build_query($bodys);
$url = $host;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));

成功響應示例 ↓  

響應（成功、失敗）示例，僅支持JSON格式。

{
"code":int0
"msg":string"查詢成功"
"data":[
0:{
"no":string"3339809700595"
"brand":string"sto"
"status":string"signed"
"data":[
0:{
"time":string"2017-10-03 19:11:00"
"context":string"已簽收,簽收人是代簽"
}
1:{
"time":string"2017-10-03 08:14:33"
"context":string"快件已到達 浙江浦江公司"
}
2:{
"time":string"2017-10-03 01:09:41"
"context":string"由浙江義烏中轉部 發往 浙江浦江公司"
}
]
"order":string"desc"
}
]
}

失敗響應示例  ↓  

{
"code":string"錯誤代碼"
"msg":string"錯誤信息"
"data":{}
}

錯誤碼

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

 

- the end -