PHP使用第三方即時獲取物流動態

前言

最近做的項目有個要求，要使用物流單號即時查詢物流信息，從網上得知，關於物流的第三方API還是很多的，而我選用的是快遞鳥，快遞鳥是一個免費的第三方接口，Api整合全球400餘家物流快遞接口，永久免費不限次，接口與快遞公司多通道通信，可用性達到99.9%以上，推送速度定製配置，保證接入方系統的穩定。

使用過程

登錄網站http://www.kdniao.com/首先要註冊，註冊完之後，在用戶管理後臺，有一個申請API選項，注意，申請API之前需要實名認證，認證完之後就可以申請API了，它的API接口還是很豐富的。

因爲我要是用的是即時查詢，所以申請的就是即時查詢的api。

api的使用流程圖

從流程圖中可以看到

1. 用戶只要提供快遞單號和快遞公司
2. 通過api得到物流狀態，並把結果返回
3. 我們拿到結果，進行實時處理顯示。

API參數

上面這些都是官方給出的關於API的參數，不過我們可以看官方的demo進行了解。官方的demo也是簡單易懂的。我們可以把它再次封裝。

封裝API

使用API需要三個固定參數
1. 商戶id
2. API key
3. 請求url,ReqURL

商戶id和API key都可以在快遞鳥網站的我的管理首頁看到，而請求url就是http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx，這個可以在接口文檔中看到。

主方法

/**
 * @param $ShipperCode 快遞公司編號
 * @param $order_sn 運單號
 */
public function getMessage($ShipperCode,$order_sn){
    $requestData= "{'OrderCode':'','ShipperCode':'".$ShipperCode."','LogisticCode':'".$order_sn."'}";
    $datas = array(
        'EBusinessID' => self::EBusinessID,
        'RequestType' => '1002',//接口指令1002，固定
        'RequestData' => urlencode($requestData) ,
        'DataType' => '2', //數據返回格式 2 json
    );
    //把$requestData進行加密處理
    $datas['DataSign'] = $this -> encrypt($requestData, self::AppKey);
    $result = $this -> sendPost( self::ReqURL, $datas);
    return $result;
}

這主方法中，傳遞進去的參數有兩個，一個是快遞公司編號，一個是物流訂單號。

我們還需要把$requestData進行加密處理，也就是encrypt方法。

/*
 * 進行加密
 */
function encrypt($data, $appkey) {
    return urlencode(base64_encode(md5($data.$appkey)));
}

加密過後就直接通過ReqURL進行訪問，返回的數據就是物流信息。

源代碼

<?php
/**
 * 使用快遞鳥api進行查詢
 * User: Administrator
 * Date: 2017/4/22 0022
 * Time: 09:09
 */
class KuaidiController{

    const EBusinessID = 1285564;
    const AppKey = '264ff9e0-2f4c-48d5-877f-1e0670400d18';
    const ReqURL = "http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx";

    /**
     * @param $ShipperCode 快遞公司編號
     * @param $order_sn 運單號
     */
    public function getMessage($ShipperCode,$order_sn){
        $requestData= "{'OrderCode':'','ShipperCode':'".$ShipperCode."','LogisticCode':'".$order_sn."'}";
        $datas = array(
            'EBusinessID' => self::EBusinessID,
            'RequestType' => '1002',//接口指令1002，固定
            'RequestData' => urlencode($requestData) ,
            'DataType' => '2', //數據返回格式 2 json
        );
        //把$requestData進行加密處理
        $datas['DataSign'] = $this -> encrypt($requestData, self::AppKey);
        $result = $this -> sendPost( self::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;
    }


    /*
     * 進行加密
     */
    function encrypt($data, $appkey) {
        return urlencode(base64_encode(md5($data.$appkey)));
    }
}
$model = new KuaidiController();
$res = $model -> getMessage('ZTO','12345678');
echo "<pre>";
var_dump($res);