一、接口名称：

物流查询接口

二、接口介绍：

快递查询接口通过输入快递单号和快递代号查询实时物流信息，支持国内外1500+物流快递公司的物流跟踪服务，包括顺丰、圆通、申通、中通、韵达等主流快递公司。同时，支持单号识别快递物流公司，返回快递运送轨迹及状态等信息，广泛用于主要应用于个人快递跟踪查询、企业批量发货物流实时获取、货运管理、企业生产链管理等。

三、API接口文档

1、请求地址

url：https://api.shumaidata.com/v4/express3/query

请求方式 method：get/post

2、签名算法说明：

服务商分配的appid、当前时间毫秒数timestamp、服务商分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。

 如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc ;

 拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;

 加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;

3、正确返回：

{

   "msg": "成功",

   "success": true,

   "code": 200,

   "data": {

       "orderNo": "296141744182247312",

       "info": [

           {

               "cpCode": "ZTO",// 快递代号

               "theLastTime": "2022-05-09 22:45:05", //运单号物流流转当前最新变更时间

               "mailNo": "75876648253690", //快递单号

               "theLastMessage": "您的快递已签收, 签收人在【多多买菜的鹤岭xx幢x单元】(鹤岭xx幢x单元)领取。

      如有疑问请电联:（13700001111）, 投诉电话:（13700001111）, 您的快递已经妥投。风里来雨里去,

      只为客官您满意。上有老下有小, 赏个好评好不好？【请在评价快递员处帮忙点亮五颗星星哦~】",

      //运单号物流流转当前最新描述

               "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、15700001111）的匡光明（15500001111） 已揽收"

             //物流流转描述

                   },

                   {

                       "areaCode": "CN530100000000",

                       "areaName": "云南省,昆明市",

                       "subLogisticsStatus": "TRANSPORT",

                       "time": 1651840449000,

                       "logisticsStatus": "TRANSPORT",

                       "desc": "快件离开 【昆明经开民办科技园】 已发往 【昆明中转】"

                   }，

                   {

                       "subLogisticsStatus": "STA_INBOUND",

                       "time": 1652091544000,

                       "logisticsStatus": "DELIVERING",

                       "desc": "快件已被【多多买菜的鹤岭xx幢x单元】代收，如有问题请电联（13700001111），

         感谢使用中通快递，期待再次为您服务！"

                   },

                   {

                       "subLogisticsStatus": "STA_SIGN",

                       "time": 1652107505000,

                       "logisticsStatus": "SIGN",

                       "desc": "您的快递已签收, 签收人在【多多买菜的鹤岭xx幢x单元】(鹤岭xx幢x单元)领取。

            如有疑问请电联:（13700001111）, 投诉电话:（13700001111）, 您的快递已经妥投。

            风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好？

            【请在评价快递员处帮忙点亮五颗星星哦~】"

                   }

               ],

               "logisticsStatus": "SIGN" //物流流转状态，详见：物流状态编码对照表;

           }

       ]

   }

}

4、错误返回：

{

   "msg": "入参错误"，

   "success": false,

   "code": 400,

   "data": {}

}

注：物流状态对照表和快递代号列表请联系工作人员获取

5、返回字段说明：

6、code错误码说明