快递查询

根据快递单号查询快递状态信息，支持国内常规快递公司和物流公司，信息更新及时

限个人实名用户使用

10000次

100000次

1000000次

申请接口

产品功能
API文档

常用快递

根据快递单号查询快递状态信息，支持国内常规快递公司和物流公司，信息更新及时

快递查询

快递物流跟踪（实时）

调用地址： https://api.topthink.com/express/query

请求方式：POST

返回类型：JSON

API 调用： 调用说明

名称	必填	类型	说明
com	是	string	快递公司字母简称。可以使用auto代替,此时将自动识别快递单号。【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】
nu	是	string	需要查询的快递单号
phone	否	string	手机尾号后四位【寄件人手机号或者收件人手机号】

$client = new Client("访问令牌")

$result = $client->expressQuery()
    ->withCom("com")
    ->withNu("nu")
    ->withPhone("phone")
    ->request();

名称	类型	说明
updateStr	string	更新时间
logo	string	快递公司logo
status	int	快递状态 1 暂无记录 2 在途中 3 派送中 4 已签收 (完结状态) 5 用户拒签 6 疑难件 7 无效单 (完结状态) 8 超时单 9 签收失败 10 退回
tel	string	快递公司联系方式
data	array	物流信息
ret_code	int	0 查询成功或提交成功。 1 输入参数错误。 2 查不到物流信息。 3 单号不符合规则。 4 快递公司编码不符合规则。 5 快递查询渠道异常。 6 auto时未查到单号对应的快递公司,请指定快递公司编码。 7 单号与手机号不匹配其他参数：接口调用失败
expSpellName	string	快递编码
mailNo	string	快递单号
queryTimes	int	无走件记录时被查询次数注意：在24小时内，查询次数>10次将会计费
flag	bool	true：查询成功，表示ret_code=0且data的长度>0。可使用本字段做是否读取data列表的依据。 false：查询失败。
expTextName	string	快递简称
possibleExpList	array	自动识别结果

{
	"code":0,
	"message":"操作成功",
	"data":{
   "update": 1653528013043,
    "upgrade_info": "",
    "updateStr": "2022-05-26 09:20:13",
    "logo": "http://static.showapi.com/app2/img/expImg/yuantong.jpg",
    "dataSize": 11,
    "status": 4,
    "fee_num": 1,
    "tel": "021-69777888/95554",
    "data": [
      {
        "time": "2022-05-17 22:10:46",
        "context": "【四川省成都市大丰】 已发出 下一站 【成都转运中心公司】"
      },
      {
        "time": "2022-05-17 21:26:31",
        "context": "【四川省成都市大丰公司】 已打包"
      },
      {
        "time": "2022-05-17 21:25:56",
        "context": "【四川省成都市大丰公司】 已揽收 取件人:xxx (13*******11)"
      }
    ],
    "expSpellName": "yuantong",
    "mailNo": "YT6493188734653",
    "queryTimes": 1,
    "ret_code": 0,
    "flag": true,
    "expTextName": "圆通速递",
    "possibleExpList": []
	}
}

快递公司列表

不计次

调用地址： https://api.topthink.com/express/exp_list