PHP使用第三方即时获取物流动态实例详解

前言

最近做的项目有个要求，要使用物流单号即时查询物流信息，从网上得知，关于物流的第三方API还是很多的，而我选用的是快递鸟，快递鸟是一个免费的第三方接口，Api整合全球400余家物流快递接口，永久免费不限次，接口与快递公司多通道通信，可用性达到99.9%以上，推送速度定制配置，保证接入方系统的稳定。

使用过程

登录网站http://www.kdniao.com/首先要注册，注册完之后，在用户管理后台，有一个申请API选项，注意，申请API之前需要实名认证，认证完之后就可以申请API了，它的API接口还是很丰富的。

因为我要是用的是即时查询，所以申请的就是即时查询的api。

api的使用流程图

从流程图中可以看到

用户只要提供快递单号和快递公司

通过api得到物流状态，并把结果返回

我们拿到结果，进行实时处理显示。

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;
}

这主方法中，传递进去的参数有两个，一个是快递公司编号，一个是物流订单号。