稳定、快速的API服务

物流快递信息查询,我们致力于为用户提供专业的免费API数据接口服务

物流快递信息查询 v1.0

最后更新: 2026-09-02 12:12:08

通过查询查询快递单号,查询对应实时物流信息和轨迹,覆盖千余家物流快递公司。

按次计费(¥0.01/次) 调用次数: 0 正常运行 响应速度: <100ms 需要传入API密钥

接口信息

接口地址:
https://api.shuliancloud.com/v4/express3/query
请求方式: GET/POST
返回格式: JSON

调用统计

0
今日调用
0
总调用次数
请求示例 https://api.shuliancloud.com/v4/express3/query

点击右侧按钮复制完整请求地址,参数值请替换为实际有效值

请求参数 (暂无请求参数)

参数名 是否必填 参数类型 参数说明
暂无请求参数信息

请求参数说明

|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名,<a href='#sign'>签名算法说明</a>  |
| type  |  varchar | 否   |快递代号,不传将自动识别|
| number | varchar  | 是  | 快递单号  |
| mobile | varchar | 否| 查顺丰/跨越速运时要输入寄件人或收件人手机号, 11位完整手机号或手机号后4位

返回参数 (暂无返回参数)

参数名 参数类型 参数说明
暂无返回参数信息

返回参数说明

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识,true为成功,false为失败,失败情况下,会有对应描述和状态码  |   
| code  |成功为200,200时收费,其它为失败状态码   | 
| msg  | code对应的说明描述   | 
| data  | 查询结果详细信息|  
| order_no| 订单号
| info | 物流信息,字段解释见返回示例
|logisticsStatus | 物流状态编码对照表,可联系工作人员获取

返回示例

{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "orderNo": "296141744182247312",
        "info": [
            {
                "cpCode": "ZTO",// 快递代号
                "theLastTime": "2022-05-09 22:45:05", //运单号物流流转当前最新变更时间
                "mailNo": "75876648253690", //快递单号
                "theLastMessage": "您的快递已签收", //运单号物流流转当前最新描述
                "cpMobile": "95311", //快递公司电话
                "logisticsCompanyName": "中通快递", //快递公司名称
                "cpUrl": "https://www.zto.com/", //快递公司官网
                "takeTime": "2天21小时45分", //从揽收到送达所耗时间
                "courier": "张三",//快递员
                "courierPhone": "13800000000",//快递员联系方式
                "logisticsStatusDesc": "已签收", //运单号当前物流状态文字描述
                "logisticsTraceDetailList": [
                    {
                        "areaCode": "CN530100000000", //当前节点所在地址行政编码
                        "areaName": "云南省,昆明市", //当前节点所在地区,省,市,区或省,市
                        "subLogisticsStatus": "ACCEPT", //物流流转子状态,详见:物流状态编码对照表
                        "time": 1651840444000, //时间,单位毫秒
                        "logisticsStatus": "ACCEPT", //物流流转状态,详见:物流状态编码对照表
                        "desc": "【昆明经开民办科技园】(952270、15752010312) 的 匡光明(15559664312) 已揽收" //物流流转描述
                    }
                ],
                "logisticsStatus": "SIGN" //物流流转状态,详见:物流状态编码对照表;
            }
        ]
    }
}