## 常用快递查询  > 根据快递单号查询快递状态信息，支持国内常规快递公司和物流公司，信息更新及时 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ## 接口1：根据单号查询快递信息 ### 接口费用（[点击购买](https://market.topthink.com/product/100)） > 最低 0.008元/次 ### 请求地址 ``` GET https://api.topthink.com/express/query ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是 |string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | com | 是 | string | 快递公司字母简称。可以使用auto代替,此时将自动识别快递单号。【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】 | | nu | 是 | string | 需要查询的快递单号 | | phone| 否 | string | 手机尾号后四位【寄件人手机号或者收件人手机号】| ### 返回参数 | 参数名称 | 类型 | 示例值 | 描述 | | --- | --- | --- | --- | | update | Number | 1588071235436 | 更新时间戳 | | upgrade\_info | String | | 提示信息，用于提醒用户可能出现的情况 | | updateStr | String | 2020-04-28 18:53:55 | 更新时间 | | logo | String | http://app2.showapi.com/img/expImg/zto.jpg | 快递公司logo | | dataSize | Number | 11 | 数据节点的长度 | | status | Number | 4 | 快递状态 1 暂无记录 2 在途中 3 派送中 4 已签收 (完结状态) 5 用户拒签 6 疑难件 7 无效单 (完结状态) 8 超时单 9 签收失败 10 退回 | | fee\_num | Number | 1 | 计费次数。例如：0为计费0次，即不计费；1为计费1次 | | tel | String | 95311 | 快递公司联系方式 | | data | Object\[\] | | | | -| time | String | 2019-11-16 21:33:56 | | | -| context | String | 快件已在 【九江城西港】 签收, 签收人: 速递易, 如有疑问请电联:（15779254414）, 投诉电话:（13687028760）, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好？【请在评价快递员处帮忙点亮五颗星星哦~】 | | | expSpellName | String | zhongtong | 快递编码 | | msg | String | 查询成功 | 返回提示信息 | | mailNo | String | 75312165465979 | 快递单号 | | queryTimes | Number | 1 | 无走件记录时被查询次数 注意：在24小时内，查询次数>10次将会计费 | | ret\_code | Number | 0 | 0 查询成功 或 提交成功。 1 输入参数错误。 2 查不到物流信息。 3 单号不符合规则。 4 快递公司编码不符合规则。 5 快递查询渠道异常。 6 auto时未查到单号对应的快递公司,请指定快递公司编码。 7 单号与手机号不匹配 其他参数：接口调用失败 | | flag | Boolean | true | true：查询成功，表示ret\_code=0且data的长度>0。可使用本字段做是否读取data列表的依据。 false：查询失败。 | | expTextName | String | 中通快递 | 快递简称 | | possibleExpList | String\[\] | \[\] | 自动识别结果 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->expressQuery() ->withCom('快递公司简称') ->withNu('运单号') ->request(); ``` ## 接口2：快递公司列表（免费） ### 请求地址 ``` GET https://api.topthink.com/express/exp_list ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | expName| 否 | string | 快递公司关键词 | | maxSize| 否 | string | 分页时,返回的最大数据量 | | page| 否 | string | 当前页数| ### 返回参数 | 名称 | 类型 | 描述 | | --- | --- | --- | | expressList | String | 快递公司列表数据 | | - expName | String | 快递公司名称 | | - simpleName | String | 简称 | | - url | String | 官方网址 | | - note | String | 描述 | | - phone | String | 快递公司服务电话 | | - imgUrl | String | 快递公司图标 | JSON返回示例： ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->expressExpList() ->withExpName('如风') ->withMaxSize(20) ->request(); ``` 返回示例： ~~~ { "code":0, "message":"操作成功", "data":{ "page": 1, "expressList": [ { "imgUrl": "http://app2.showapi.com/img/expImg/rufeng.jpg", "simpleName": "rufeng", "phone": "400-010-6660", "expName": "如风达快递", "note": "", "url": "http://www.rufengda.com" }, { "imgUrl": "http://app2.showapi.com/img/expImg/562.gif", "simpleName": "rufengda", "phone": "400-010-6660", "expName": "凡客如风达", "note": "", "url": "http://www.rufengda.com" } ], "allNum": 2, "msg": "查询成功!", "maxSize": 20 } } ~~~