快遞鳥api介面實現訂閱物流軌跡單號查詢功能對接呼叫

背景：

分享一篇關於在電商系統中同步物流軌跡到本地伺服器的文章，當前方案使用了快遞鳥整合api做為資料來源介面，這個介面是免費使用的，不過提供的功能還是非常強大的，有專門的售後維護團隊。有多種語言demo可以進行呼叫

實現思路大概分為三大步：

第一步：提交訂閱資訊到快遞鳥的介面

第二步：快遞鳥收到請求後會對回撥地址進行跟蹤，將快遞資訊推送給回撥介面

第三步：回撥介面收到Post推送的資料後，進行邏輯處理

注意：回撥的地址建議單獨部署一個API專案，不要放在主程式下面；或者在提交訂閱時要求對回撥進行簽名驗證。

一、對接流程

快遞鳥網站申請介面KEY並認證-對接介面-除錯-上線使用

二、對接準備  1. 登入快遞鳥註冊快賬號  2.獲取開發者賬號資訊（ID ,API Key）， 登入快遞鳥後臺中檢視  3.進行技術聯調，並完成除錯，物流軌跡查詢api地址：  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', ');
//請求url：正式地址
defined('ReqURL') or define('ReqURL', ');
$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)));
}
?>