异步创建

POST/api/v2/trackings/create

每次可以创建 1–1000 条跟踪。请求受理后，Tracksuite 在后台异步处理。

参数

data 为跟踪数组，每批 1–1000 条。同批 referId 不可重复。字段与 创建跟踪 相同。

dataarray必填

要创建的跟踪。

字段

referIdstring必填

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

rawTrackingNumberstring必填

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

metadata.carrierCodestring可选

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

返回

success: true 表示批次已进入异步处理。每条跟踪的结果可通过查询一条跟踪或 Webhook 获取。尚未处理完时，查询可能返回 Processing。

successboolean

批次已进入处理队列时为 true。

cURL

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

响应示例

{
  "success": true
}