这篇文章主要介绍了关于快递鸟物流轨迹信息单号识别查询Api接口使用,有着一定的参考价值,现在分享给大家,有需要的朋友可以参考一下
背景:
项目开发中,有些需求难免会用到关于快递的一些Api接口;本篇主要介绍的是快递的查询Api及与其他各家的不同之处;
常用的提供快递Api接口有:快递鸟、菜鸟、快递公司等等
如大家使用过有些api接口的时候,你会发现,你所申请的账号或key每天调用Api接口的次数都是被限制的,有的是2000次/天,有的是5000次/次;唯一让你感到麻烦的是,要求用户添加外链,而快递鸟不需要用户添加外链。对于无门户网站的用户,无非就是很苛刻的要求;并且,超出部分需付费才能使用。
快递鸟,请求Api接口是不限制次数的哟,并且永久免费
固然,对于你小小的需求的话,有些接口都可满足你的需求;但是,当万一某天请求次数太多,你的查询服务就得停止,影响你的产品体验;所以,推荐你直接使用快递鸟,一步到位。
应用场景
可实现需求
-
App中直接集成实现快递物流信息查询Api接口
-
在微信公众号中,根据用户输入的订单号,我们的后台识别订单号并根据快递鸟查询快递Api接口,实现自动查询的功能
-
等等
申请Key
对接准备
1.登录快递鸟注册快账号
2.获取开发者账号信息(ID ,API Key),登录快递鸟后台中查看
3.进行技术联调,并完成调试,物流查询api地址:http://www.kdniao.com/api-track
4.在您的软件中集成快递物流查询接口
按照你的信息,依次把信息填写完整,点击提交申请即可。
登录成功后,就可以看到ID和key等信息,有这些信息就可以请求查询等其他的接口Api
技术对接
快递鸟提供的快递查询接口,支持418家快递物流查询,涵盖了国内外主流快递服务企业的单号查询,信息及时,数据完整。
登录快递鸟官网支持多种开发语言对接,包括JAVA,C#,PHP等。根据您的开发语言,选择参考对应的代码示例,下面以PHP代码为例:
<?php
//电商ID
defined('EBusinessID') or define('EBusinessID', '123456');
//电商加密私钥,快递鸟提供,注意保管,不要泄漏
defined('AppKey') or define('AppKey', '1234567890');
//请求url:测试地址
//defined('ReqURL') or define('ReqURL', 'http://sandboxapi.kdniao.cc:8080/kdniaosandbox/gateway/exterfaceInvoke.json');
//请求url:正式地址
defined('ReqURL') or define('ReqURL', 'http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx');
$kgs = "JD";//快递公司简称,官方有文档
$number = "12345678";//快递单号
//调用查询物流轨迹
//---------------------------------------------
$logisticResult=getOrderTracesByJson($kgs,$number);
echo $logisticResult;
//解析数据
$data = json_decode($logisticResult,true);
if($data['Success'] == true){//返回信息成功
$str = "";
if(isset($data['Traces']) && !empty($data['Traces'])){
for($i=0;$i<count($data['Traces']);$i++){
$str .= "时间:".$data['Traces'][$i]['AcceptTime']."<br/>地址:".$data['Traces'][$i]['AcceptStation']."<br/>";
}
}
echo "您查询的单号是:".$data['LogisticCode']."<br/>
物流信息:<br/>".$str."";
}
//---------------------------------------------
/**
* Json方式 查询订单物流轨迹
*/
function getOrderTracesByJson($kgs,$number){
$requestData= "{'OrderCode':'','ShipperCode':'$kgs','LogisticCode':'$number'}";
$datas = array(
'EBusinessID' => EBusinessID,
'RequestType' => '1002',
'RequestData' => urlencode($requestData) ,
'DataType' => '2',
);
$datas['DataSign'] = encrypt($requestData, AppKey);
$result=sendPost(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;
}
/**
* 电商Sign签名生成
* @param data 内容
* @param appkey Appkey
* @return DataSign签名
*/
function encrypt($data, $appkey) {
return urlencode(base64_encode(md5($data.$appkey)));
}
?>
来源:oschina
链接:https://my.oschina.net/u/4384701/blog/3386462