📦 接口文档

🌐 English Version

POST tracking 获取轨迹

地址：/api/order/tracking　·　说明：获取订单物流轨迹。

参数说明

参数	必填	类型	说明
order_id	是	int	订单 ID（仅能操作当前客户自己的订单）

请求示例

POST /api/order/tracking
Header: vendor-token: xxxxx
Content-Type: application/json
{
    "order_id": 1024
}

返回示例（data 为渠道统一返回结构）

{
    "success": true,
    "message": "获取轨迹成功！",
    "code": 200,
    "data": {
        "trackingNumber": "9212345678901234567890",   // 跟踪号
        "status": "delivered",                 // 轨迹状态
        "statusCategory": "delivered",           // 状态分类
        "serviceTypeCode": "144",               // STC 代码
        "originCity": "LOS ANGELES",
        "originState": "CA",
        "originZIP": "90001",
        "destinationCity": "NEW YORK",
        "destinationState": "NY",
        "destinationZIP": "10001",
        "trackingEvents": [{
            "eventType": "Delivered, Left with Individual",
            "eventTimestamp": "2026-10-01T11:04:19",
            "eventCountry": "US",
            "eventCity": "DES PLAINES",
            "eventState": "IL",
            "eventZIP": "60016",
            "location": "DES PLAINES,IL,60016",
            "timeZone": "GMT-05:00",
            "eventCode": "01",
            "GMTTimestamp": "2026-10-01T16:04:19Z"
        }]
    }
}

data 字段说明

data 字段	类型	说明
trackingNumber	string	跟踪号
status / statusCategory	string	轨迹状态 / 渠道状态分类（如 delivered）
serviceTypeCode	string	STC 代码
origin* / destination*	string	始发 / 目的地 城市、州简码、邮编
trackingEvents	array	轨迹事件集合，每项含 eventType / eventTimestamp / eventCountry / eventCity / eventState / eventZIP / location / timeZone / eventCode / GMTTimestamp