跳转到内容
开始使用

查询摘要

POST/api/v1/routers/summary

按 referId 批量查摘要，响应不含物流轨迹。每个 referId 单独处理，所以 data 和 errors 可以同时有数据。

参数

Section titled “参数”
referIdsarray必填

要查询的业务标识。至少一条，每条最长 128 个字符。

返回

Section titled “返回”
dataarray

查到的跟踪。

字段
referIdstring
请求里的业务标识。
rawTrackingNumberstring
创建时传入的运单号。
trackNumberstring
路由器上的运单号。
statusnumber
状态码。见运单状态。
statusLabelstring
状态名，例如 TRANSIT。
routerobject
这条跟踪的路由摘要。
data.routerobject

data.router 上的字段。

字段
idstring
路由 ID。
trackingNumberstring
运单号。
destinationTrackingNumberstring
末端运单号。
carrierCodestring
承运商编码。
carrierNamestring
承运商名称。
statusTrackstring
承运商状态，例如 transit。
statusnumber
状态码。
statusLabelstring
状态名。
hasIssuenumber
有异常为 1，否则为 0。
latestEventstring | null
最新事件说明。
latestCheckpointTimestring | null
最新事件时间。
transitTimenumber
运输天数。
deliveryDatestring | null
妥投时间。
pickupDatestring | null
取件时间。
expressDatestring | null
发货时间。
firstTimestring | null
首条事件时间。
firstStatestring | null
首条事件的州或省。
firstCitystring | null
首条事件的城市。
firstZipCodestring | null
首条事件的邮编。
latestStatestring | null
最新事件的州或省。
latestCitystring | null
最新事件的城市。
latestZipCodestring | null
最新事件的邮编。
createdstring
路由创建时间。
updatedstring
路由更新时间。
errorsarray

没有出现在 data 里的 referId。

字段
referIdstring
请求里的业务标识。
codestring
NOT_FOUND、PROCESSING、UPDATE_FAILED 或 CREATE_FAILED。
messagestring
这条 referId 未返回的原因。