前言
最近做的项目有个要求,要使用物流单号即时查询物流信息,从网上得知,关于物流的第三方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,这个可以在接口文档中看到。
主方法
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" ;
/**
* @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使用第三方即时获取物流动态,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对服务器之家网站的支持!
原文链接:http://blog.csdn.net/li741350149/article/details/70807667