更新时间:2022-08-15 22:48:54
背景
最近进行网站后台开发,需要实现物流的即时查询, 为了方便以后的业务需求,经过比较,最后选择使用第三方快递查询接口服务商 ——【快递鸟】
同时,在此进行整理,希望能帮到有需求的道友们,谢谢 ...
官方文档: 快递鸟 —— 即时查询API
开发框架:ThinkPHP5.1.2
开发步骤
①. 前期准备
首先要进行快递鸟账号的注册
快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册
快递鸟API key免费注册
并根据对方的要求,完善用户申请。
然后,根据自己的需求,开通所需服务(如果只是进行物流信息的查询,以当前业务查询次数较少为例):
②. 集成类的使用
首先需要登录 快递鸟 ,获取账号的 用户ID和 API key
注册完成后登入,进入到个人中心,这里需要进行一个实名认证,按公司产品的类型进行一个选择,展示页面如下图
快递鸟实名认证
认证完成后在我的产品服务中选择自己所需要的服务,当然对于初创型公司来说选择免费版就够了,等到业务做大时再选择其他产品服务
还有就是在个人中心中如下图所示,我们需要记住的是用户ID,和API key(不要泄露),这将是我们进行接口调用时需要用到的,
对所提供源码中的 集成类 BirdExpress.php,进行配置项的==替换操作==
然后
将集成类整合到你的项目框架,根据框架规则进行必要修改(框架不同规则自然多数不同,本人为 ThinkPHP5.1.2)
下图为简单的调用测试:
③. 核心处理方法源码
首先,官方的代码 demo获得的物流信息是==正序展示==的
为了方便物流信息的倒序展示,我进行了对数组Traces的==反转操作==
/**
* 核心方法
* Json方式 查询订单物流轨迹
* @param string $ShipperCode 快递公司编码
* @param string $LogisticCode 物流单号
* @param int $arrayFlag 是否进行数组转化标志 默认0:否 1:转化
* 参考规则举例:
* $requestData = "{'OrderCode':'','ShipperCode':'ZTO','LogisticCode':'640041334612'}";
* @return result 包含即时物流信息的 Json数据
*/
public function getOrderTracesByJson($ShipperCode = "",$LogisticCode = "",$arrayFlag = 0)
{
$requestData = "{
'OrderCode':'',
'ShipperCode':'$ShipperCode',
'LogisticCode':'$LogisticCode'
}";
$postData = array(
'EBusinessID' => $this->EBusinessID,
'RequestType' => '1002',//接口指令1002
'RequestData' => urlencode($requestData),
'DataType' => '2',
);
$postData['DataSign'] = $this->encrypt($requestData, $this->AppKey);
$result = $this->sendPost($this->ReqURL, $postData);
//根据公司业务处理返回的信息......
if ($arrayFlag){
$result = json_decode($result,true);
//TODO 方便物流信息的倒序展示,进行数组反转
$result['Traces'] = array_reverse($result['Traces']);
}
return $result;
}
④. 效果展示截图
通过上面核心源码的展示,你应该会注意到
调用其方法,必须要传入 ==快递公司编码== 和 ==物流单号== 这两个参数
好在,官方提供了 快递公司编码, 所以,鄙人的设计思路如下:
如果需要进行 excel表的导入操作,可直接参考对应文章: ThinkPHP5.1 excel表的导入导出操作 (PHPExcel)
源码上传 >>>
附录
为什么我选择使用快递鸟API
首先,我拥有一个,测试物流单号:640041334612 (中通快递),然后使用多个快递查询服务,效果如下:
通過比較发现: