查询一条跟踪

GET/api/v1/routers/detail

查询一条跟踪，包含轨迹。传入 referId 或 trackingNumber，至少要有一个。找不到时返回 404。

参数

referIdstring可选

创建时的业务标识。

trackingNumberstring可选

运单号。

firstRequestRange.startstring可选

时间范围起点，ISO 8601。需和 firstRequestRange.end 一起传。

firstRequestRange.endstring可选

时间范围终点，ISO 8601。需和 firstRequestRange.start 一起传。

返回

trackingNumberstring

运单号。

statusnumber

状态码。见运单状态。

statusLabelstring

状态名，例如 TRANSIT。

summaryobject

这条跟踪的路由摘要。

字段

idstring

路由 ID。

trackingNumberstring

运单号。

destinationTrackingNumberstring

末端运单号。

carrierCodestring

承运商编码。

carrierNamestring

承运商名称。

statusTrackstring

承运商状态，例如 transit。

statusnumber

状态码。

statusLabelstring

状态名。

hasIssuenumber

有异常为 1，否则为 0。

latestEventstring | null

最新事件说明。

latestCheckpointTimestring | null

最新事件时间。

transitTimenumber

运输天数。

deliveryDatestring | null

妥投时间。

pickupDatestring | null

取件时间。

expressDatestring | null

发货时间。

createdstring

路由创建时间。

updatedstring

路由更新时间。

detailobject

承运商轨迹。

字段

trackingNumberstring

运单号。

statusSummarystring | null

承运商返回的最新状态说明。

trackingEventsarray | null

事件列表，新的在前。

detail.trackingEventsarray

每条事件上的字段。承运商可能还会带上下面以外的键。

字段

eventTypestring | null

事件说明。

eventCodestring | null

承运商事件码。

eventTimestampstring | null

当地时间。

GMTTimestampstring | null

UTC 时间。

GMTOffsetstring | null

相对 UTC 的时差。

eventCitystring | null

城市。

eventStatestring | null

州或省。

eventZIPCodestring | null

邮编。

eventCountrystring | null

国家。

errorobject | null

承运商返回轨迹错误时出现。

cURL

curl 'https://api.tracksuite.net/api/v1/routers/detail?referId=order-10001' \
  -H 'Authorization: your_api_key'

响应示例

{
  "trackingNumber": "9400111899223857461234",
  "status": 3,
  "statusLabel": "TRANSIT",
  "summary": {
    "trackingNumber": "9400111899223857461234",
    "carrierCode": "usps",
    "carrierName": "USPS",
    "status": 3,
    "statusLabel": "TRANSIT",
    "latestEvent": "In Transit to Next Facility"
  },
  "detail": {
    "trackingNumber": "9400111899223857461234",
    "statusSummary": "In Transit to Next Facility",
    "trackingEvents": [
      {
        "eventType": "In Transit to Next Facility",
        "eventCity": "LAS VEGAS",
        "eventState": "NV",
        "eventZIPCode": "89101",
        "eventTimestamp": "2026-07-10T05:00:00",
        "GMTTimestamp": "2026-07-10T12:00:00Z"
      }
    ]
  }
}