快递物流查询接口如何用PHP调用

loosenivy

于 2024-08-18 10:30:00 发布

阅读量226

点赞数 8

分类专栏：电商类接口文章标签： php 快递物流查询接口快递查询接口物流查询接口电商接口

本文链接：https://blog.csdn.net/loosenivy/article/details/141288644

版权

电商类接口专栏收录该内容

2 篇文章 0 订阅

订阅专栏

一、什么是快递物流查询接口？

快递物流查询接口通过输入快递单号和快递代号查询实时物流信息。该接口支持单号自动识别，可查询国内外上千家物流快递公司的物流跟踪服务，包括顺丰、圆通、申通、中通、韵达等主流快递公司。

二、物流快递接口使用哪些场景？

例如：电商平台

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"
    }
}