快递鸟api实现电商平台快递查询功能对接调用

背景：

分享一篇关于在电商系统中同步物流轨迹到本地服务器的文章，当前方案使用了快递鸟集成api做为数据来源接口，接口可以在快递鸟网站申请，提供的功能还是非常强大的，有专门的售后维护团队。有多种语言demo可以进行调用

实现思路大概分为三大步：

第一步：提交订阅信息到快递鸟的接口

第二步：快递鸟收到请求后会对回调地址进行跟踪，将快递信息推送给回调接口

第三步：回调接口收到Post推送的数据后，进行逻辑处理

注意：回调的地址建议单独部署一个API项目，不要放在主程序下面；或者在提交订阅时要求对回调进行签名验证。

一、对接流程

快递鸟网站申请接口KEY并认证-对接接口-调试-上线使用

二、对接准备 1. 登录快递鸟注册快账号 2.获取开发者账号信息（ID ,API Key）， 登录快递鸟后台中查看 3.进行技术联调，并完成调试，物流轨迹查询api地址： http://www.kdniao.com/api-track 4.在您的软件中集成快递物流查询接口

三、技术对接 快递鸟提供的快递查询接口，支持600多家快递物流查询，涵盖了国内外主流快递服务企业的单号查询，信息及时，数据完整。

登录 快递鸟官网支持多种开发语言对接，包括JAVA，C#，PHP等。根据您的开发语言，选择参考对应的代码示例，下面以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
";
    $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;
}
/**
 * 电商Sign签名生成
 * @param data 内容   
 * @param appkey Appkey
 * @return DataSign签名
 */
function encrypt($data, $appkey) {
    return urlencode(base64_encode(md5($data.$appkey)));
}
?>