欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2024-03-12 23:12:38
前言 最近做的项目有个要求,要使用物流单号即时查询物流信息,从网上得知,关于物流的第三方api还是很多的,而我选用的是快递鸟,快递鸟是一个免费的第三方接口,api整合全球...

前言

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

使用过程

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

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

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

api的使用流程图

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

从流程图中可以看到

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

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

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

api参数

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

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

上面这些都是官方给出的关于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;
}

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

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

我们还需要把$requestdata进行加密处理,也就是encrypt方法。

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

加密过后就直接通过requrl进行访问,返回的数据就是物流信息。

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

源代码

<?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);

以上所述是小编给大家介绍的php使用第三方即时获取物流动态,希望对大家有所帮助