一、什么是快递物流查询接口?
快递物流查询接口通过输入快递单号和快递代号查询实时物流信息。该接口支持单号自动识别,可查询国内外上千家物流快递公司的物流跟踪服务,包括顺丰、圆通、申通、中通、韵达等主流快递公司。
二、物流快递接口使用哪些场景?
例如:电商平台
1.实时跟踪商品物流进度,以便消费者随时了解自己购买物品的运输状态,提升购物体验。例如在淘宝、京东等大型电商平台,用户下单后可以在订单详情页面查看快递的详细动态,从包裹出库到运输途中的各个站点中转信息,再到最终送达,每一个环节都清晰可见。据统计,提供良好物流跟踪服务的电商平台,用户满意度能提高约 20%。
2.电商企业可以通过接口获取的物流数据进行分析,优化供应链管理。比如根据不同地区的物流配送时效,调整仓库布局和库存分配,对于物流配送频繁出现延误的地区,可以考虑增加合作的快递企业或者优化配送路线。
三、如何用PHP进行接口调用及正确返回示例?
下面我们以阿里云的API接口为例,具体示例代码如下:
<?php
$host = "https://kzexpress.market.alicloudapi.com";
$path = "/api-mall/api/express/query";
$method = "POST";
$appcode = "你自己的AppCode";
$headers = array();
array_push($headers, "Authorization:APPCODE " . $appcode);
//根据API的要求,定义相对应的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = "expressNo=expressNo&mobile=mobile";
$url = $host . $path;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));
?>
正确返回示例如下:
{
"msg": "成功",
"success": true,
"code": 200,
"data": {
"cpCode": "SF",// 快递公司编码
"mailNo": "SF13xxx",//快递编号
"theLastTime": "2023-04-21 19:06:47",//运单号物流流转当前最新变更时间
"cpMobile": "95338",//快递公司电话
"theLastMessage": "快件到达 【贵阳双龙中转场】",//运单号物流流转当前最新描述
"logisticsCompanyName": "顺丰快递",//快递公司名称
"cpUrl": "http://www.sf-express.com",//快递公司官网
"logisticsStatusDesc": "运输中",//运单号当前物流状态文字描,
"logisticsTraceDetailList": [
{
"areaCode": "",//非必须,当前节点所在地址行政编码
"areaName": "温州市",//非必须,当前节点所在地区,省,市,区或省,市
"subLogisticsStatus": "ACCEPT",//物流流转子状态
"time": 1718767062000,//时间,单位毫秒
"logisticsStatus": "ACCEPT",//物流流转状态
"desc": "顺丰速运 已收取快件"//物流流转描述
},
{
"areaCode": "",
"areaName": "宁波市",
"subLogisticsStatus": "AGENT_SIGN",
"time": 1718849806000,
"logisticsStatus": "SIGN",
"desc": "您的快件代签收(家门口),如有疑问请电联快递员【杨***,电话:19****237】,感谢您使用顺丰,期待再次为您服务。(主单总件数:1件)"
}
],
"logisticsStatus": "SIGN"
}
}