PHP使用第三方即時(shí)獲取物流動(dòng)態(tài)實(shí)例詳解
前言
最近做的項(xiàng)目有個(gè)要求,要使用物流單號(hào)即時(shí)查詢物流信息,從網(wǎng)上得知,關(guān)于物流的第三方API還是很多的,而我選用的是快遞鳥(niǎo),快遞鳥(niǎo)是一個(gè)免費(fèi)的第三方接口,Api整合全球400余家物流快遞接口,永久免費(fèi)不限次,接口與快遞公司多通道通信,可用性達(dá)到99.9%以上,推送速度定制配置,保證接入方系統(tǒng)的穩(wěn)定。
使用過(guò)程
登錄網(wǎng)站http://www.kdniao.com/首先要注冊(cè),注冊(cè)完之后,在用戶管理后臺(tái),有一個(gè)申請(qǐng)API選項(xiàng),注意,申請(qǐng)API之前需要實(shí)名認(rèn)證,認(rèn)證完之后就可以申請(qǐng)API了,它的API接口還是很豐富的。
因?yàn)槲乙怯玫氖羌磿r(shí)查詢,所以申請(qǐng)的就是即時(shí)查詢的api。
api的使用流程圖
從流程圖中可以看到
用戶只要提供快遞單號(hào)和快遞公司
通過(guò)api得到物流狀態(tài),并把結(jié)果返回
我們拿到結(jié)果,進(jìn)行實(shí)時(shí)處理顯示。
API參數(shù)
上面這些都是官方給出的關(guān)于API的參數(shù),不過(guò)我們可以看官方的demo進(jìn)行了解。官方的demo也是簡(jiǎn)單易懂的。我們可以把它再次封裝。
封裝API
使用API需要三個(gè)固定參數(shù)
1. 商戶id
2. API key
3. 請(qǐng)求url,ReqURL
商戶id和API key都可以在快遞鳥(niǎo)網(wǎng)站的我的管理首頁(yè)看到,而請(qǐng)求url就是
http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx,這個(gè)可以在接口文檔中看到。
主方法
/** * @param $ShipperCode 快遞公司編號(hào) * @param $order_sn 運(yùn)單號(hào) */ 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', //數(shù)據(jù)返回格式 2 json ); //把$requestData進(jìn)行加密處理 $datas['DataSign'] = $this -> encrypt($requestData, self::AppKey); $result = $this -> sendPost( self::ReqURL, $datas); return $result; }
這主方法中,傳遞進(jìn)去的參數(shù)有兩個(gè),一個(gè)是快遞公司編號(hào),一個(gè)是物流訂單號(hào)。
我們還需要把$requestData進(jìn)行加密處理,也就是encrypt方法。
/* * 進(jìn)行加密 */ function encrypt($data, $appkey) { return urlencode(base64_encode(md5($data.$appkey))); }
加密過(guò)后就直接通過(guò)ReqURL進(jìn)行訪問(wèn),返回的數(shù)據(jù)就是物流信息。
源代碼
<?php /** * 使用快遞鳥(niǎo)api進(jìn)行查詢 * 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 快遞公司編號(hào) * @param $order_sn 運(yùn)單號(hào) */ 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', //數(shù)據(jù)返回格式 2 json ); //把$requestData進(jìn)行加密處理 $datas['DataSign'] = $this -> encrypt($requestData, self::AppKey); $result = $this -> sendPost( self::ReqURL, $datas); return $result; } /** * post提交數(shù)據(jù) * @param string $url 請(qǐng)求Url * @param array $datas 提交的數(shù)據(jù) * @return url響應(yīng)返回的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; } /* * 進(jìn)行加密 */ function encrypt($data, $appkey) { return urlencode(base64_encode(md5($data.$appkey))); } } $model = new KuaidiController(); $res = $model -> getMessage('ZTO','12345678'); echo "<pre>"; var_dump($res);
以上所述是小編給大家介紹的PHP使用第三方即時(shí)獲取物流動(dòng)態(tài),希望對(duì)大家有所幫助,如果大家有任何疑問(wèn)請(qǐng)給我留言,小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持!
相關(guān)文章
php curl請(qǐng)求接口并獲取數(shù)據(jù)的示例代碼
本篇文章主要介紹了php curl請(qǐng)求接口并獲取數(shù)據(jù)的示例代碼,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2017-08-08Zend Framework教程之配置文件application.ini解析
這篇文章主要介紹了Zend Framework教程之配置文件application.ini用法,分析了配置文件application.ini中常見(jiàn)的配置項(xiàng)含義及用法,需要的朋友可以參考下2016-03-03PHP基于CURL進(jìn)行POST數(shù)據(jù)上傳實(shí)例
這篇文章主要介紹了PHP基于CURL進(jìn)行POST數(shù)據(jù)上傳的方法,以完整的實(shí)例形式較為詳細(xì)的講述了PHP采用curl進(jìn)行POST數(shù)據(jù)傳遞的方法,具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2014-11-11Centos6.5和Centos7 php環(huán)境搭建方法
這篇文章主要介紹了Centos6.5和Centos7 php環(huán)境搭建方法的相關(guān)資料,非常不錯(cuò),具有參考借鑒價(jià)值,需要的朋友可以參考下2016-05-05