快递查询API的的用途和对接分析

一、背景介绍

      商品的交易模式这几十年来经历的转变：步行到就近的小集市交易——骑车到较远的大集市交易——坐车或开车到市区的大商场交易——上网交易（快递转运）；当然这仅仅是个人观点，但这个发展的潮流趋势应该还是没有问题的。也就是说在现如今的社会中，越来越多的交易就在网联网上沟通完成，方便快捷，在这种情形下，快递行业的兴起然后迅速发展壮大也算是应运而生、理所当然。在这样的背景下，怎么简单方便又快捷的查询物流信息、快递网点信息、快递公司信息、快递员信息以及网上寄快递等就慢慢成了我们日益关注的问题。作为这个社会的一份子，针对不同的人群，我给一点小小的建议，也好方便大家的日常生活。

   1.散户

     如果您是散户，建议您可以去快递网官网（www.kuaidi.com）直接查询您的快递物流信息，同时还可以进行快递网点的查询、快递公司联系方式的查询、快递员联系方式的查询以及网上寄快递等等服务；另外您也可以在手机上免费下载一个快递网的APP，这些服务同样能够享受，还非常方便；或者也可以关注一下快递网的微信公众号，同样也能做到。补充说明一点，有的去快递公司官网查询的时候是需要输入验证码的。

   2.手机APP商店、微信商城等没有自己网站的商户

     大家也都知道，现在的手机功能很强大，我们在好多APP或者微信商城、微信平台等等上都可以购买东西，而下了单之后肯定想实时跟踪商品的物流信息，这种群体建议可以去联系一下专门做这种快递查询服务的公司，比如快递网（www.kuaidi.com），可以做一个免费跳转的物流信息跟踪查询链接，这样既方便了卖家，同时也能让买家享受到更好的服务。需要的可以联系qq：2885643506。

   3.电商网站、企业内部系统或者在线管理系统

     这种一般都是拥有一定需求量的需求型群体，独个的去查询或者做跳转链接已经不适用了，这种情况下就比较适合对接一个快递查询的接口来实现一站式集成查询。这样做的好处就在于不管是哪一家快递公司的物流信息都可以在对接这样一个接口之后都可以实现实时的跟踪查询，方便快捷。下面以介绍一个快递网免费的快递查询API接口。

二、快递查询API接口对接示例

     无需申请，可直接对接使用，文档中有key可直接用到请求地址中。

    1.输入参数的定义：

   2.返回结果定义：

3.PHP源码文件：

      1>KuaidiAPI.php

<?php
/**
 * Created by http://www.kuaidi.com
 * User: kuaidi.com PHP team
 * Date: 2016-03-02
 * 物流信息查询接口SDK
 * QQ: 2885643506
 * Version 1.0
 */

class KuaidiAPI{
    
    private $_APPKEY = ''; 
    
    private $_APIURL = "http://highapi.kuaidi.com/openapi-querycountordernumber.html?";
    
    private $_show = 0;

    private $_muti = 0;

    private $_order = 'desc';
    
    /**
     * 您获得的快递网接口查询KEY。
     * @param string $key
     */
    public function KuaidiAPi($key){
        $this->_APPKEY = $key;
    }

    /**
     * 设置数据返回类型。0: 返回 json 字符串; 1:返回 xml 对象
     * @param number $show
     */
    public function setShow($show = 0){
        $this->_show = $show;
    }
    
    /**
     * 设置返回物流信息条目数, 0:返回多行完整的信息; 1:只返回一行信息
     * @param number $muti
     */
    public function setMuti($muti = 0){
        $this->_muti = $muti;
    }
    
    /**
     * 设置返回物流信息排序。desc:按时间由新到旧排列; asc:按时间由旧到新排列
     * @param string $order
     */
    public function setOrder($order = 'desc'){
        $this->_order = $order;
    }

    /**
     * 查询物流信息，传入单号，
     * @param 物流单号 $nu
     * @param 公司简码 $com 要查询的快递公司代码,不支持中文,具体请参考快递公司代码文档。
     * @throws Exception
     * @return array
     */
    public function query($nu, $com=''){
        if (function_exists('curl_init') == 1) {
            
            $url = $this->_APIURL;

            $dataArr = array(
                'id' => $this->_APPKEY,
                'com' => $com,
                'nu' => $nu,
                'show' => $this->_show,
                'muti' => $this->_muti,
                'order' => $this->_order
            );

            foreach ($dataArr as $key => $value) {
                $url .= $key . '=' . $value . "&";
            }

            // echo $url;

            $curl = curl_init();
            curl_setopt($curl, CURLOPT_URL, $url);
            curl_setopt($curl, CURLOPT_HEADER, 0);
            curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
            curl_setopt($curl, CURLOPT_TIMEOUT, 10);
            $kuaidresult = curl_exec($curl);
            curl_close($curl);

            if($this->_show == 0){
                $result = json_decode($kuaidresult, true);
            }else{
                $result = $kuaidresult;
            }

            return $result;

        }else{
            throw new Exception("Please install curl plugin", 1); 
        }
    }

}

　　

    2>example.php

<?php

include 'KuaidiAPI.php';

//修改成你自己的KEY
$key = 'c684ab43a28bc3caea53570666ce9762'; 

$kuaidichaxun = new KuaidiAPi($key);

//设置返回格式。 0: 返回 json 字符串; 1:返回 xml 对象
//$kuaidichaxun->setShow(1); //可选，默认为 0 返回json格式

//返回物流信息条目数。 0:返回多行完整的信息; 1:只返回一行信息
//$kuaidichaxun->setMuti(1); //可选，默认为0

//设置返回物流信息排序。desc:按时间由新到旧排列; asc:按时间由旧到新排列
//$kuaidichaxun->setOrder('asc');

//查询
$result = $kuaidichaxun->query('111111', 'quanfengkuaidi');

//带公司短码查询，短码列表见文档
//$result = $kuaidichaxun->query('111111', 'quanfengkuaidi');

//111111 快递单号
//quanfengkuaidi   快递公司名称


var_dump($result);

 

 

 

 

 

说明：

1.KuadidiAPI.php 不需要修改改任何东西
2.example.php 按照说明使用
3.快递公司代码见快递公司代码技术文档（下载地址：https://pan.baidu.com/s/1qYtikSs）
4.如果有什么不清楚的地方，请到快递网的官网咨询（http://www.kuaidi.com/），或者拨打快递网咨询电话：18205167920 或加qq:2885643506 发邮件至guoxiangyuan@kuaidi.com

转载于:https://www.cnblogs.com/guo19901230/p/5734181.html