常用快递查询
最后更新于：2022-04-02 08:18:24
## 常用快递查询
> 根据快递单号查询快递状态信息，支持国内常规快递公司和物流公司，信息更新及时
## 接口调用（[调用须知](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
}
}
~~~
';