JAVA快遞單號查詢接口對接第三方快遞鳥api接口教程

應用場景：

 1、網站用戶后台的訂單頁面，用戶打開頁面時先調用快遞接口查詢這個用戶的訂單的快遞，然后將結果顯示在頁面中；

 2、內部快速搜索，用戶打電話過來只要問對方的名字，然后直接搜到這個用戶的訂單的快遞狀況，主要是給客服MM用；

 3、銷售系統，由於已簽收這個直接調用快遞鳥的快遞接口的參數就能獲得，所以系統可以每個星期自動將已簽收的單統計出來，形成報表，同時給客服MM和財務MM用；

 4、倉管系統，倉管的兄弟們只要將疑難件抽出來就行。

 

 

 

 【對接使用流程】

1、將快遞單號和快遞公司編碼發送給快遞鳥

2、快遞鳥根據單號和快遞公司查詢到物流軌跡狀態

3、快遞鳥將查詢到的物流軌跡狀態反饋給電商平台或ISV服務商

4、電商平台或ISV服務商接收數據並實時處理做數據展示或應用

二、對接准備
1.登錄快遞鳥注冊快賬號
2.獲取開發者賬號信息（ID ,API Key），登錄快遞鳥后台中查看
3.進行技術聯調，並完成調試，物流查詢api地址：http://www.kdniao.com/api-track
4.在您的軟件中集成快遞物流查詢接口

三、技術對接
快遞鳥提供的快遞查詢接口，支持418家快遞物流查詢，涵蓋了國內外主流快遞服務企業的單號查詢，信息及時，數據完整。

<?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)));
}

?>