快递单号物流轨迹查询API接口功能对接调用

808 阅读2分钟

背景:

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

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

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

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

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

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

一、对接流程

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

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

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

登录 快递鸟官网支持多种开发语言对接,包括JAVA,C#,PHP等。根据您的开发语言,选择参考对应的代码示例,下面以PHP代码为例:

下面附上详细代码:

<?php//电商IDdefined('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)));}?>