创建跟踪

POST/api/v1/routers/create

每次可以创建 1–40 条跟踪。大批量请用 异步创建。

参数

data 为跟踪数组，每批 1–40 条。同批 referId 不可重复。

dataarray必填

要创建的跟踪。

字段

referIdstring必填

你系统中的业务标识，例如订单号。最长 128 个字符。

rawTrackingNumberstring必填

承运商运单号。最长 300 个字符。

metadata.carrierCodestring可选

承运商编码。不传时按运单号识别。最长 64 个字符。

返回

success 是已入队的跟踪，errors 是未入队的跟踪。同一批里每条单独受理或拒绝，所以一次 200 里两个列表都可以有数据。这次只说明哪些单进入了处理队列。轨迹之后用查询一条跟踪或 Webhook 获取。这次响应没有物流轨迹。

successarray

已进入处理队列的跟踪。

字段

referIdstring

请求里的业务标识。

trackingNumberstring

这条跟踪受理后的运单号。

carrierCodestring

匹配到的承运商编码。

carrierNamestring

匹配到的承运商名称。

errorsarray

未进入队列的跟踪。

字段

referIdstring

请求里的业务标识。

messagestring

这条跟踪未入队的原因。

cURL

curl 'https://api.tracksuite.net/api/v1/routers/create' \
  -H 'Authorization: your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"data":[{"referId":"order-10001","rawTrackingNumber":"9400111899223857461234","metadata":{"carrierCode":"usps"}}]}'

响应示例

{
  "success": [
    {
      "referId": "order-10001",
      "carrierName": "USPS",
      "carrierCode": "usps",
      "trackingNumber": "9400111899223857461234"
    }
  ],
  "errors": []
}