杂项

查询快递物流信息

0次调用
40 积分/次

买了东西想知道快递到哪儿了?这个接口帮你实时追踪物流状态。

功能概述

提供一个快递单号,系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等主流快递公司的物流信息。

使用须知

  • 自动识别:不知道是哪家快递?系统会根据单号规则自动识别快递公司(推荐使用)
  • 手动指定:如果已知快递公司,可以传递 carrier_code 参数,查询速度会更快
  • 手机尾号验证:顺丰等部分快递公司需要验证收件人手机尾号才能查询详细物流,如果返回 暂无物流信息,建议尝试传入 phone 参数
  • 查询时效:物流信息实时查询,响应时间通常在1-2秒内

查询参数

tracking_number
string必填

快递单号,通常是一串10-20位的数字或字母数字组合。

carrier_code
string可选

快递公司编码(可选)。不填写时系统会自动识别,填写后可加快查询速度。

phone
string可选

收件人手机尾号,4位数字(可选)。部分快递公司需要验证手机尾号才能查询详细物流信息。

响应

200 / 请求成功

查询成功!直接返回快递的完整物流轨迹。

JSON

400 / 错误的请求

参数错误,请检查快递单号是否正确。

JSON

404 / 未找到

当前没有查询到物流轨迹时会返回 404,并附带错误码和提示信息。如果返回此错误,建议尝试传入 phone 参数(收件人手机尾号)再次查询。

JSON