物流跟踪
端点
| 方法 | 端点 | 描述 |
|---|---|---|
| GET | /api/v202206/trackings | Retrieves a list of trackings |
头部
| 键 | 值 |
|---|---|
| Authorization | Bearer eyJ0eXAiOiJKV1QiLCJhbGciOi ... |
GET /api/v202105/Trackings
请求
参数
| 类型 | 名称 | 描述 | 必填/选填 | 数据结构 |
|---|---|---|---|---|
| query | api | API 类型 可用值: index.by-default | 必填 | enum |
| query | next_token | 下一页数据的秘钥 | 选填 | string |
| body | tracking_numbers | 追踪号列表 | 必填 | array |
Body 示例
{
"tracking_numbers": [ "UUXXXXXXXX1","UUXXXXXXXX2"]
}返回
| 键 | 值 |
|---|---|
| errcode | 0/4000 |
| errmsg | ok/Error Info |
| data | Data Properties |
Data Properties
| 名称 | 描述 | 数据结构 |
|---|---|---|
| tracking_number | 跟踪号 | string |
| platform_order_id | 平台订单号 | string |
| customer_order_id | 客户订单号 | string |
| trx_id | ShipSage 系统内部订单编号 | string |
| carrier | 发货渠道; 例如: UPS, USPS, DHL, FedEx... | string |
| service_type_name | 物流承运商 例如： UPS Ground, UPS Sure Post, Fedex Ground Home Delivery, Fedex Ground... | string |
| latest_status | 最新状态 | string |
| latest_event_time | 最新轨迹发生时间 时区：太平洋 标准时间 | datetime |
| latest_event_time_iso | 最新轨迹发生当地时间 | datetime |
| latest_event_time_utc | 最新轨迹发生时间 时区：国际标准时间 | datetime |
| latest_event_描述 | 最新轨迹描述 | string |
| final_scan_time | 仓库最终扫描时间 太平洋标准时间 | datetime |
| origin_scan_time | 物流商揽收时间 太平洋标准时间 | datetime |
| delivered_time | 妥投时间 太平洋标准时间 | datetime |
| ship_to_name | 收件人姓名 | string |
| ship_to_address1 | 收件人街道地址1 | string |
| ship_to_address2 | 收件人街道地址2 | string |
| ship_to_phone | 收件人电话 | string |
| ship_to_city | 收件人城市 | string |
| ship_to_state | 收件人州/省 | string |
| ship_to_country | 收件人国家 | string |
| ship_to_postal_code | 收件人邮编 | string |
| milestone | 轨迹里程碑节点 | array |
| milestone.*.event_time | 轨迹发生时间 时区：太平洋标准时间 | datetime |
| milestone.*.event_time_iso | 轨迹发生当地时间 | datetime |
| milestone.*.event_time_utc | 轨迹发生时间 时区：国际标准时间 | datetime |
| milestone.*.描述 | 轨迹描述 | string |
| milestone.*.location | 轨迹发生位置 | string |
| milestone.*.stage | 轨迹发生主节点 | string |
| milestone.*.sub_status | 轨迹发生子节点 | string |
| milestone.*.country | 轨迹发生国家 | string |
| milestone.*.state | 轨迹发生州/省 | string |
| milestone.*.city | 轨迹发生城市 | string |
| milestone.*.street | 轨迹发生街道 | string |
| postal_code | 轨迹发生邮编 | integer |
返回示例
{
"errcode": 0,
"errmsg": "ok",
"data": [
{
"tracking_number": "UUXXXXXXXX1",
"platform_order_id": "XXXXXXX",
"customer_order_id": "XXXXXXX",
"trx_id": "e28de150-bbde-480d-b1e5-67070907b50d1729568339403",
"carrier": "FedEx",
"service_type_name": "GROUND_HOME_DELIVERY",
"latest_status": "Delivered",
"latest_event_time": "2024-06-17 10:36:04",
"latest_event_time_iso": "2024-06-17 13:36:04",
"latest_event_time_utc": "2024-06-17 17:36:04",
"latest_event_描述": "Delivered, Left at front door. Signature Service not 请求ed.",
"final_scan_time": "2024-06-16 04:25:02",
"origin_scan_time": "2024-06-16 00:00:00",
"delivered_time": "2024-06-17 13:36:04",
"ship_to_name": "XXX",
"ship_to_address1": "XXX",
"ship_to_address2": null,
"ship_to_phone": "16026716610",
"ship_to_city": "BAKERSFIELD",
"ship_to_state": "CA",
"ship_to_country": "US",
"ship_to_postal_code": "10000",
"milestone": [
{
"event_time": "2024-06-15 21:00:00",
"event_time_iso": "2024-06-16 00:00:00",
"event_time_utc": "2024-06-16 04:00:00",
"描述": "Picked up",
"location": "US, PA, NORTHAMPTON",
"stage": "PickedUp",
"sub_status": "InTransit_PickedUp",
"country": "US",
"state": "PA",
"city": "NORTHAMPTON",
"street": "",
"postal_code": 1000
},
{
"event_time": "2024-06-15 21:10:00",
"event_time_iso": "2024-06-16 00:10:00",
"event_time_utc": "2024-06-16 04:10:00",
"描述": "Shipment information sent to FedEx",
"location": "US, PA, NORTHAMPTON",
"stage": "InfoReceived",
"sub_status": "InfoReceived",
"country": "US",
"state": "PA",
"city": "NORTHAMPTON",
"street": "",
"postal_code": 1000
},
{
"event_time": "2024-06-16 14:53:00",
"event_time_iso": "2024-06-16 17:53:00",
"event_time_utc": "2024-06-16 21:53:00",
"描述": "Arrived at FedEx location",
"location": "US, PA, NORTHAMPTON",
"stage": "",
"sub_status": "InTransit_Other",
"country": "US",
"state": "PA",
"city": "NORTHAMPTON",
"street": "",
"postal_code": 1000
},
{
"event_time": "2024-06-16 22:57:52",
"event_time_iso": "2024-06-17 01:57:52",
"event_time_utc": "2024-06-17 05:57:52",
"描述": "Left FedEx origin facility",
"location": "US, PA, NORTHAMPTON",
"stage": "",
"sub_status": "InTransit_Other",
"country": "US",
"state": "PA",
"city": "NORTHAMPTON",
"street": "",
"postal_code": 1000
},
{
"event_time": "2024-06-17 01:35:00",
"event_time_iso": "2024-06-17 04:35:00",
"event_time_utc": "2024-06-17 08:35:00",
"描述": "At local FedEx facility",
"location": "US, PA, READING",
"stage": "",
"sub_status": "InTransit_Other",
"country": "US",
"state": "PA",
"city": "READING",
"street": "",
"postal_code": 1001
},
{
"event_time": "2024-06-17 01:48:00",
"event_time_iso": "2024-06-17 04:48:00",
"event_time_utc": "2024-06-17 08:48:00",
"描述": "On FedEx vehicle for delivery",
"location": "US, PA, READING",
"stage": "OutForDelivery",
"sub_status": "OutForDelivery_Other",
"country": "US",
"state": "PA",
"city": "READING",
"street": "",
"postal_code": 1001
},
{
"event_time": "2024-06-17 10:36:04",
"event_time_iso": "2024-06-17 13:36:04",
"event_time_utc": "2024-06-17 17:36:04",
"描述": "Delivered, Left at front door. Signature Service not 请求ed.",
"location": "US, PA, Elverson",
"stage": "Delivered",
"sub_status": "Delivered_Other",
"country": "US",
"state": "PA",
"city": "Elverson",
"street": "",
"postal_code": 1001
}
]
}
]
}Modified at 2026-08-13 00:43:51