快递鸟查询订单实例

<?php
/**
 * @技术QQ群: 可登录官网https://www.kdniao.com/右侧查看技术群号
 * @see: https://kdniao.com/api-track
 * @copyright: 深圳市快金数据技术服务有限公司
 * ID和Key请到官网申请:https://kdniao.com/reg



 * 即时查询接口
 * 此接口用于向快递公司实时查询物流轨迹信息。该功能支持情况需查看技术文档。
 * 正式地址:https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx
 *
 *
 * 系统级参数
 * RequestData       String    R    请求内容为JSON格式 详情可参考接口技术文档:https://www.kdniao.com/documents
 * EBusinessID       String    R    用户ID
 * RequestType       String    R    请求接口指令
 * DataSign           String    R    数据内容签名,加密方法为:把(请求内容(未编码)+ApiKey)进行MD5加密--32位小写,然后Base64编码,最后进行URL(utf-8)编码
 * DataType           String    R    DataType=2,请求、返回数据类型均为JSON格式


 * 应用级参数
 * R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
 * OrderCode      String(30)    O    订单编号
 * ShipperCode      String(10)    R    快递公司编码  详细编码参考《快递鸟接口支持快递公司编码.xlsx》 https://www.kdniao.com/documents
 * LogisticCode      String(30)    R    快递单号
 * CustomerName      String(50)    C    ShipperCode为SF时必填,对应寄件人/收件人手机号后四位;ShipperCode为其他快递时,可不填或保留字段,不可传值

 * 请求示例
 * ZTO请求示例:
 * {
 * "OrderCode": "",
 * "ShipperCode": "ZTO",
 * "LogisticCode": "638650888018",
 * }
 *
 * JD请求示例:
 * {
 * "OrderCode": "",
 * "CustomerName": "",
 * "ShipperCode": "JD",
 * "LogisticCode": "JDVA00003618100",
 * }
 *
 * SF请求示例:
 * {
 * "OrderCode": "",
 * "CustomerName": "1234",
 * "ShipperCode": "SF",
 * "LogisticCode": "SF00003618100",
 * }
 */



//用户ID,快递鸟提供,注意保管,不要泄漏
defined('EBusinessID') or define('EBusinessID', '888888');//即用户ID,登录快递鸟官网会员中心获取 https://www.kdniao.com/UserCenter/v4/UserHome.aspx 
//API key,快递鸟提供,注意保管,不要泄漏
defined('ApiKey') or define('ApiKey', 'c2fb3a23-de82-418c-9411-1234567890');//即API key,登录快递鸟官网会员中心获取 https://www.kdniao.com/UserCenter/v4/UserHome.aspx
//请求url,正式地址
defined('ReqURL') or define('ReqURL', 'https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx');

$CustomerName = $_REQUEST['CustomerName'];
$ShipperCode = 'JTSD';
$LogisticCode = 'JT2097977556048';

$logisticResult = getOrderTracesByJson($CustomerName,$ShipperCode,$LogisticCode);
echo $logisticResult;


function getOrderTracesByJson($CustomerName='',$ShipperCode,$LogisticCode){
  // 组装应用级参数
    $requestData = [
        "CustomerName" =>$CustomerName,
        "OrderCode"    =>'',
        "ShipperCode"  =>$ShipperCode,
        "LogisticCode" =>$LogisticCode
    ];
    $requestData = json_encode($requestData);
//    var_dump($requestData);die;
  // 组装系统级参数
    $datas = array(
        'EBusinessID' => EBusinessID,
        'RequestType' => '1002', //免费即时查询接口指令1002/在途监控即时查询接口指令8001/地图版即时查询接口指令8003
        'RequestData' => urlencode($requestData) ,
        'DataType' => '2',
    );
    $datas['DataSign'] = encrypt($requestData, ApiKey);
  //以form表单形式提交post请求,post请求体中包含了应用级参数和系统级参数
    $result=sendPost(ReqURL, $datas);    
    
    //根据公司业务处理返回的信息......
    
    return $result;
}
 
/**
 *  post提交数据 
 * @param  string $url 请求Url
 * @param  array $datas 提交的数据 
 * @return url响应返回的html
 */
function sendPost($url, $datas) {
    $postdata = http_build_query($datas);
    $options = array(
      'http' => array(
        'method' => 'POST',
        'header' => 'Content-type:application/x-www-form-urlencoded',
        'content' => $postdata,
        'timeout' => 15 * 60 // 超时时间(单位:s)
      )
    );
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    return $result;
}

/**
 * 电商Sign签名生成
 * @param data 内容   
 * @param ApiKey ApiKey
 * @return DataSign签名
 */
function encrypt($data, $ApiKey) {
    return urlencode(base64_encode(md5($data.$ApiKey)));
}

?>

 

posted @ 2024-10-30 14:59  流浪2024  阅读(46)  评论(0编辑  收藏  举报