通知轨迹信息
POST
{{your_server_url}}
请求参数
Header 参数
method
string
必需
示例值:
NOTIFY_TRACE
Body 参数application/json
method
string
通知方法（NOTIFY_TRACE）
data
object
必需
refno
string
参考号
trackingno
string
跟踪号
carrier
string
承运商（UPS、DHL）
product_code
string
渠道代码
to
string
目的地二字码
quantity
integer
件数
weight
number
计费重量
events
array [object {10}]
轨迹信息
示例
{
"method": "NOTIFY_TRACE",
"data": {
"refno": "888888888888",
"trackingno": "1Z88888888888888888888",
"carrier": "UPS",
"product_code": "HKUDF01",
"to": "US",
"quantity": 1,
"weight": 1,
"events": [
{
"code": "IR",
"description": "Shipment information received",
"datetime": "2024-06-16 21:51:47",
"time_zone": "GMT+08:00",
"location": "SHENZHEN, GD - CHINA",
"country": "CN",
"province": "GD",
"city": "SHENZHEN",
"zipcode": "518103",
"transfer_flag": false,
"flight_no": ""
},
{
"code": "AF",
"description": "Has entered the warehouse",
"datetime": "2024-06-18 20:20:51",
"time_zone": "GMT+08:00",
"location": "SHENZHEN,GD-CHINA",
"country": "CHINA",
"province": "GD",
"city": "SHENZHEN",
"zipcode": null,
"transfer_flag": false,
"flight_no": null
},
{
"code": "DF",
"description": "Out warehouse",
"datetime": "2024-06-19 00:32:48",
"time_zone": "GMT+08:00",
"location": "SHENZHEN,GD-CHINA",
"country": "CHINA",
"province": "GD",
"city": "SHENZHEN",
"zipcode": null,
"transfer_flag": false,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-19 17:09:00",
"time_zone": "GMT+08:00",
"location": "Chek Lap Kok,HK",
"country": "HK",
"province": null,
"city": "Chek Lap Kok",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Export Scan",
"datetime": "2024-06-19 17:09:00",
"time_zone": "GMT+08:00",
"location": "Chek Lap Kok,HK",
"country": "HK",
"province": null,
"city": "Chek Lap Kok",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "QF",
"description": "Departed from Facility",
"datetime": "2024-06-19 19:28:00",
"time_zone": "GMT+08:00",
"location": "Chek Lap Kok,HK",
"country": "HK",
"province": null,
"city": "Chek Lap Kok",
"zipcode": null,
"transfer_flag": true,
"flight_no": "5X1937"
},
{
"code": "LD",
"description": "Arrived at Facility",
"datetime": "2024-06-19 13:18:00",
"time_zone": "GMT-08:00",
"location": "Anchorage,AK,US",
"country": "US",
"province": "AK",
"city": "Anchorage",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-19 15:09:00",
"time_zone": "GMT-08:00",
"location": "Anchorage,AK,US",
"country": "US",
"province": "AK",
"city": "Anchorage",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-19 16:35:00",
"time_zone": "GMT-08:00",
"location": "Anchorage,AK,US",
"country": "US",
"province": "AK",
"city": "Anchorage",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-20 01:31:00",
"time_zone": "GMT-04:00",
"location": "Louisville,KY,US",
"country": "US",
"province": "KY",
"city": "Louisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Import Scan",
"datetime": "2024-06-20 02:46:00",
"time_zone": "GMT-04:00",
"location": "Louisville,KY,US",
"country": "US",
"province": "KY",
"city": "Louisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-20 04:13:00",
"time_zone": "GMT-04:00",
"location": "Louisville,KY,US",
"country": "US",
"province": "KY",
"city": "Louisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-20 05:25:00",
"time_zone": "GMT-04:00",
"location": "Greensboro,NC,US",
"country": "US",
"province": "NC",
"city": "Greensboro",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-20 05:52:00",
"time_zone": "GMT-04:00",
"location": "Greensboro,NC,US",
"country": "US",
"province": "NC",
"city": "Greensboro",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-20 06:41:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Processing at UPS Facility",
"datetime": "2024-06-20 07:04:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Processing at UPS Facility",
"datetime": "2024-06-20 08:58:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-25 06:00:00",
"time_zone": "GMT-04:00",
"location": "Morrisville,NC,US",
"country": "US",
"province": "NC",
"city": "Morrisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Processing at UPS Facility",
"datetime": "2024-06-25 09:03:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "OD",
"description": "Out For Delivery Today",
"datetime": "2024-06-25 10:01:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "CC",
"description": "Delivered",
"datetime": "2024-06-25 17:38:00",
"time_zone": "GMT-04:00",
"location": "CHAPEL HILL,NC,US",
"country": "US",
"province": "NC",
"city": "CHAPEL HILL",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
}
]
}
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{your_server_url}}' \
--header 'method: NOTIFY_TRACE' \
--header 'Content-Type: application/json' \
--data-raw '{
"method": "NOTIFY_TRACE",
"data": {
"refno": "888888888888",
"trackingno": "1Z88888888888888888888",
"carrier": "UPS",
"product_code": "HKUDF01",
"to": "US",
"quantity": 1,
"weight": 1.0,
"events": [
{
"code": "IR",
"description": "Shipment information received",
"datetime": "2024-06-16 21:51:47",
"time_zone": "GMT+08:00",
"location": "SHENZHEN, GD - CHINA",
"country": "CN",
"province": "GD",
"city": "SHENZHEN",
"zipcode": "518103",
"transfer_flag": false,
"flight_no": ""
},
{
"code": "AF",
"description": "Has entered the warehouse",
"datetime": "2024-06-18 20:20:51",
"time_zone": "GMT+08:00",
"location": "SHENZHEN,GD-CHINA",
"country": "CHINA",
"province": "GD",
"city": "SHENZHEN",
"zipcode": null,
"transfer_flag": false,
"flight_no": null
},
{
"code": "DF",
"description": "Out warehouse",
"datetime": "2024-06-19 00:32:48",
"time_zone": "GMT+08:00",
"location": "SHENZHEN,GD-CHINA",
"country": "CHINA",
"province": "GD",
"city": "SHENZHEN",
"zipcode": null,
"transfer_flag": false,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-19 17:09:00",
"time_zone": "GMT+08:00",
"location": "Chek Lap Kok,HK",
"country": "HK",
"province": null,
"city": "Chek Lap Kok",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Export Scan",
"datetime": "2024-06-19 17:09:00",
"time_zone": "GMT+08:00",
"location": "Chek Lap Kok,HK",
"country": "HK",
"province": null,
"city": "Chek Lap Kok",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "QF",
"description": "Departed from Facility",
"datetime": "2024-06-19 19:28:00",
"time_zone": "GMT+08:00",
"location": "Chek Lap Kok,HK",
"country": "HK",
"province": null,
"city": "Chek Lap Kok",
"zipcode": null,
"transfer_flag": true,
"flight_no": "5X1937"
},
{
"code": "LD",
"description": "Arrived at Facility",
"datetime": "2024-06-19 13:18:00",
"time_zone": "GMT-08:00",
"location": "Anchorage,AK,US",
"country": "US",
"province": "AK",
"city": "Anchorage",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-19 15:09:00",
"time_zone": "GMT-08:00",
"location": "Anchorage,AK,US",
"country": "US",
"province": "AK",
"city": "Anchorage",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-19 16:35:00",
"time_zone": "GMT-08:00",
"location": "Anchorage,AK,US",
"country": "US",
"province": "AK",
"city": "Anchorage",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-20 01:31:00",
"time_zone": "GMT-04:00",
"location": "Louisville,KY,US",
"country": "US",
"province": "KY",
"city": "Louisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Import Scan",
"datetime": "2024-06-20 02:46:00",
"time_zone": "GMT-04:00",
"location": "Louisville,KY,US",
"country": "US",
"province": "KY",
"city": "Louisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-20 04:13:00",
"time_zone": "GMT-04:00",
"location": "Louisville,KY,US",
"country": "US",
"province": "KY",
"city": "Louisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-20 05:25:00",
"time_zone": "GMT-04:00",
"location": "Greensboro,NC,US",
"country": "US",
"province": "NC",
"city": "Greensboro",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-20 05:52:00",
"time_zone": "GMT-04:00",
"location": "Greensboro,NC,US",
"country": "US",
"province": "NC",
"city": "Greensboro",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "WB",
"description": "Arrived at Facility",
"datetime": "2024-06-20 06:41:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Processing at UPS Facility",
"datetime": "2024-06-20 07:04:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Processing at UPS Facility",
"datetime": "2024-06-20 08:58:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Departed from Facility",
"datetime": "2024-06-25 06:00:00",
"time_zone": "GMT-04:00",
"location": "Morrisville,NC,US",
"country": "US",
"province": "NC",
"city": "Morrisville",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "ND",
"description": "Processing at UPS Facility",
"datetime": "2024-06-25 09:03:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "OD",
"description": "Out For Delivery Today",
"datetime": "2024-06-25 10:01:00",
"time_zone": "GMT-04:00",
"location": "Mebane,NC,US",
"country": "US",
"province": "NC",
"city": "Mebane",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
},
{
"code": "CC",
"description": "Delivered",
"datetime": "2024-06-25 17:38:00",
"time_zone": "GMT-04:00",
"location": "CHAPEL HILL,NC,US",
"country": "US",
"province": "NC",
"city": "CHAPEL HILL",
"zipcode": null,
"transfer_flag": true,
"flight_no": null
}
]
}
}'返回响应
🟢200成功
application/json
Body
ack
boolean
必需
errors
array [object {1}]
失败信息
message
string
失败信息
示例
{
"ack": true,
"errors": []
}修改于 2024-07-22 02:54:27