前言
最近做的項(xiàng)目有個(gè)要求，要使用物流單號(hào)即時(shí)查詢物流信息，從網(wǎng)上得知，關(guān)于物流的第三方API還是很多的，而我選用的是快遞鳥，快遞鳥是一個(gè)免費(fèi)的第三方接口，Api整合全球400余家物流快遞接口，永久免費(fèi)不限次，接口與快遞公司多通道通信，可用性達(dá)到99.9%以上，推送速度定制配置，保證接入方系統(tǒng)的穩(wěn)定。
使用過程
登錄網(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)和快遞公司
通過api得到物流狀態(tài)，并把結(jié)果返回
我們拿到結(jié)果，進(jìn)行實(shí)時(shí)處理顯示。
API參數(shù)
上面這些都是官方給出的關(guān)于API的參數(shù)，不過我們可以看官方的demo進(jìn)行了解。官方的demo也是簡(jiǎn)單易懂的。我們可以把它再次封裝。
封裝API
使用API需要三個(gè)固定參數(shù)
1. 商戶id
2. API key
3. 請(qǐng)求url,ReqURL
商戶id和API key都可以在快遞鳥網(wǎng)站的我的管理首頁看到，而請(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)));
}
加密過后就直接通過ReqURL進(jìn)行訪問，返回的數(shù)據(jù)就是物流信息。
源代碼
<?php
/**
* 使用快遞鳥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);