前言
最近做的项目有个要求,要使用物流单号即时查询物流信息,从网上得知,关于物流的第三方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;}
这主方法中,传递进去的参数有两个,一个是快递公司编号,一个是物流订单号。
我们还需要把$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= "{"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"; $httpheader.= "Host:" . $url_info["host"] . ""; $httpheader.= "Content-Type:application/x-www-form-urlencoded"; $httpheader.= "Content-Length:" . strlen($post_data) . ""; $httpheader.= "Connection:close"; $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 == "" || $header == "")) { 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使用第三方即时获取物流动态,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对网页设计网站的支持!