快递查询API接口查询

按快递单号查询物流轨迹。filters：com（公司编号，取自 cloud.express_com 命中的 no）、no（单号，也可用 query）、senderPhone / receiverPhone（寄/收件人手机后四位；顺丰/中通/跨越须填其一）。

已开放调用入口：POST /v1/data/query。

请求体字段

字段	类型	说明	示例
domain	string	数据域（必填）	`cloud`
type	string	数据类型（必填）	`express`
query	string	自然语言检索词	`321231533756338`
filters	object	结构化过滤条件，见下方「常用 filters」	—

常用 filters

字段	类型	说明	示例
com	string	快递公司编号（必填），如 sf/sto/yt；取自 express_com.no	`yd`
no	string	快递单号（也可用 query）	`321231533756338`
senderPhone	integer	寄件人手机号后四位	`1234`
receiverPhone	integer	收件人手机号后四位	`5678`

返回字段（hits[]）

字段	类型	说明
company	string	快递公司名
com	string	公司编号
no	string	运单号
status	string	状态码
status_detail	string	状态明细
list	list	物流轨迹列表
source	string	来源标识
disclaimer	string	数据口径说明
raw	object	原始载荷

list：物流轨迹列表

字段	类型	说明
datetime	string	节点时间
remark	string	节点描述
zone	string	所在地区（若有）

curl 请求示例

curl -sS -X POST https://data.devnors.com/v1/data/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain":"cloud", "type":"express", "query":"321231533756338", "filters":{ "com":"yd" } }'

将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见统一查询。