首页 > 代码库 > PHP使用第三方即时获取物流动态

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= "http://www.mamicode.com/{‘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= "http://www.mamicode.com/{‘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 = http://www.mamicode.com/implode(‘&‘, $temps);"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);
<script type="text/javascript"> $(function () { $(‘pre.prettyprint code‘).each(function () { var lines = $(this).text().split(‘\n‘).length; var $numbering = $(‘
    ‘).addClass(‘pre-numbering‘).hide(); $(this).addClass(‘has-numbering‘).parent().append($numbering); for (i = 1; i <= lines; i++) { $numbering.append($(‘
  • ‘).text(i)); }; $numbering.fadeIn(1700); }); }); </script>

    PHP使用第三方即时获取物流动态