批量查询

POST/api/v1/routers/details

查询一条跟踪 的批量形式。可传 trackingNumbers、referIds，或两个都传。每个数组最多 40 条，且至少有一个数组不为空。每条单独处理，所以 data 和 errors 可以同时有数据。

参数

trackingNumbersarray可选

运单号。每条最长 128 个字符，最多 40 条。

referIdsarray可选

业务标识。每条最长 128 个字符，最多 40 条。

firstRequestRangeobject可选

只匹配这个时间范围内的记录。start 和 end 要一起传。

字段

startstring必填

起点，ISO 8601。

endstring必填

终点，ISO 8601。

返回

data 里每一条与查询一条跟踪相同。summary 还会多出 firstTime、firstState、firstCity、firstZipCode、latestState、latestCity、latestZipCode。

dataarray

查到的跟踪，包含轨迹。

errorsarray

没有出现在 data 里的条目。

字段

referIdstring | null

请求使用 referIds 时的业务标识。

trackingNumberstring | null

请求使用 trackingNumbers 时的运单号。

codestring

NOT_FOUND、DETAIL_NOT_FOUND、PROCESSING、UPDATE_FAILED 或 CREATE_FAILED。

messagestring

这条未返回的原因。

cURL

curl 'https://api.tracksuite.net/api/v1/routers/details' \
  -H 'Authorization: your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"referIds":["order-10001"],"trackingNumbers":["9400111899223857461234"]}'

响应示例

{
  "data": [
    {
      "trackingNumber": "9400111899223857461234",
      "status": 3,
      "statusLabel": "TRANSIT",
      "summary": {
        "trackingNumber": "9400111899223857461234",
        "carrierCode": "usps",
        "status": 3,
        "statusLabel": "TRANSIT"
      },
      "detail": {
        "trackingEvents": []
      }
    }
  ],
  "errors": []
}