前言
最近做的项目有个要求，要使用物流单号即时查询物流信息，从网上得知，关于物流的第三方API还是很多的，而我选用的是快递鸟，快递鸟是一个非常方便的第三方接口，Api整合全球600余家物流快递接口，接口与快递公司多通道通信，可用性达到99.9%以上，推送速度定制配置，保证接入方系统的稳定。
使用过程
登录网站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就是
api.kdniao.cc/Ebusiness/E…，这个可以在接口文档中看到。
主方法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/**
* @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方法。
1
2
3
4
5
6
/*
* 进行加密
*/
function encrypt(``$data``, $appkey``) {
return urlencode(``base64_encode``(md5(``$data``.``$appkey``)));
}
加密过后就直接通过ReqURL进行访问，返回的数据就是物流信息。
源代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<?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](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``);
