快遞鳥集成快遞單號查詢API接口,可以同時對接順豐快遞查詢,中通、申通、圓通、韻達、百世、EMS等國內外418家物流快遞公司接口查詢等。這些快遞物流企業,提供了快遞單號自動識別接口,快遞單號查詢接口等快遞物流服務。對於電商企業,ERP服務企業,集成此接口到自己的軟件中,增加了企業的競爭力。
一、接口應用場景
1.在電商平臺購物後,通過購物訂單跟蹤物流時,調用此API獲取物流信息詳情
2.處理運費對賬時,一鍵獲取運單物流狀態
3.批量跟蹤及獲取運單物流信息
對接流程
快遞鳥網站申請接口KEY並認證-對接接口-調試-上線使用
二、對接準備
1.登錄快遞鳥註冊快賬號
2.獲取開發者賬號信息(ID ,API Key),登錄快遞鳥後臺中查看
3.進行技術聯調,並完成調試,物流查詢api地址:http://www.kdniao.com/api-track
4.在您的軟件中集成快遞物流查詢接口
三、技術對接
快遞鳥提供的快遞查詢接口,支持418家快遞物流查詢,涵蓋了國內外主流快遞服務企業的單號查詢,信息及時,數據完整。
登錄快遞鳥官網支持多種開發語言對接,包括JAVA,C#,PHP等。根據您的開發語言,選擇參考對應的代碼示例,下面以PHP代碼爲例:
<?php
//電商ID
defined('EBusinessID') or define('EBusinessID', '123456');
//電商加密私鑰,快遞鳥提供,注意保管,不要泄漏
defined('AppKey') or define('AppKey', '1234567890');
//請求url:測試地址
//defined('ReqURL') or define('ReqURL', 'http://sandboxapi.kdniao.cc:8080/kdniaosandbox/gateway/exterfaceInvoke.json');
//請求url:正式地址
defined('ReqURL') or define('ReqURL', 'http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx');
$kgs = "JD";//快遞公司簡稱,官方有文檔
$number = "12345678";//快遞單號
//調用查詢物流軌跡
//---------------------------------------------
$logisticResult=getOrderTracesByJson($kgs,$number);
echo $logisticResult;
//解析數據
$data = json_decode($logisticResult,true);
if($data['Success'] == true){//返回信息成功
$str = "";
if(isset($data['Traces']) && !empty($data['Traces'])){
for($i=0;$i<count($data['Traces']);$i++){
$str .= "時間:".$data['Traces'][$i]['AcceptTime']."<br/>地址:".$data['Traces'][$i]['AcceptStation']."<br/>";
}
}
echo "您查詢的單號是:".$data['LogisticCode']."<br/>
物流信息:<br/>".$str."";
}
//---------------------------------------------
/**
* Json方式 查詢訂單物流軌跡
*/
function getOrderTracesByJson($kgs,$number){
$requestData= "{'OrderCode':'','ShipperCode':'$kgs','LogisticCode':'$number'}";
$datas = array(
'EBusinessID' => EBusinessID,
'RequestType' => '1002',
'RequestData' => urlencode($requestData) ,
'DataType' => '2',
);
$datas['DataSign'] = encrypt($requestData, AppKey);
$result=sendPost(ReqURL, $datas);
//根據公司業務處理返回的信息......
return $result;
}
/**
* post提交數據
* @param string $url 請求Url
* @param array $datas 提交的數據
* @return url響應返回的html
*/
function sendPost($url, $datas) {
$temps = array();
foreach ($datas as $key => $value) {
$temps[] = sprintf('%s=%s', $key, $value);
}
$post_data = implode('&', $temps);
$url_info = parse_url($url);
if(empty($url_info['port']))
{
$url_info['port']=80;
}
$httpheader = "POST " . $url_info['path'] . " HTTP/1.0\r\n";
$httpheader.= "Host:" . $url_info['host'] . "\r\n";
$httpheader.= "Content-Type:application/x-www-form-urlencoded\r\n";
$httpheader.= "Content-Length:" . strlen($post_data) . "\r\n";
$httpheader.= "Connection:close\r\n\r\n";
$httpheader.= $post_data;
$fd = fsockopen($url_info['host'], $url_info['port']);
fwrite($fd, $httpheader);
$gets = "";
$headerFlag = true;
while (!feof($fd)) {
if (($header = @fgets($fd)) && ($header == "\r\n" || $header == "\n")) {
break;
}
}
while (!feof($fd)) {
$gets.= fread($fd, 128);
}
fclose($fd);
return $gets;
}
/**
* 電商Sign簽名生成
* @param data 內容
* @param appkey Appkey
* @return DataSign簽名
*/
function encrypt($data, $appkey) {
return urlencode(base64_encode(md5($data.$appkey)));
}
?>