- 通用接口
- 海运数据接口
- 船期表接口
- 港到港船期
- 航线规划路径
- 航次挂靠路径
- 空运数据接口
- 陆运数据接口
- 关务数据接口
- 快递数据接口
- 其他接口
快递数据下载接口
GET
/api/express/download
2.所有的时间字段都是字符串类型，格式为 "yyyy-MM-dd HH:mm:ss"， 如果时间没有值则为空字符串""。
请求参数
Query 参数
companyCode
string
必需
token
string
必需
orgCode
string
组织代码
billId
string
必需
示例值:
1927637103627579392,1927614365332508672
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.trackingeyes.com/api/express/download?companyCode=&token&orgCode&billId=1927637103627579392,1927614365332508672'返回响应
🟢200成功
application/json
Body
code
integer
状态代码
codeDesc
string
状态描述
<= 8 字符
message
string
异常信息
<= 255 字符
result
array [object {54}]
结果集
id
string
运单关键字
<= 32 字符
localKey
string
客户本地关键字
<= 38 字符
orgCode
string
所属组织代码
<= 64 字符
customer
string
客户
<= 128 字符
status
string
订阅状态
<= 10 字符
errorDes
string
订阅失败信息
<= 255 字符
trackNo
string
快递单号
<= 32 字符
slug
string
快递承运商代码
<= 28 字符
slugGroup
string
快递承运商集团代码
<= 28 字符
language
string
动态描述语言
<= 2 字符
transitDays
string
运输天数
<= 2 字符
isActive
string
活跃标志
<= 1 字符
orgCountryCd
string
始发地国家/地区代码
<= 3 字符
orgState
string
始发地州/省
<= 32 字符
orgCity
string
始发地城市
<= 24 字符
orgPostCd
string
始发地邮政编号
<= 10 字符
org
string
始发地地点全称
<= 128 字符
dstCountryCd
string
目的地国家/地区代码
<= 3 字符
dstState
string
目的地州/省
<= 32 字符
dstCity
string
目的地城市
<= 24 字符
dstPostCd
string
目的地邮政编号
<= 10 字符
dst
string
目的地地点全称
<= 128 字符
etd
string <date-time>
预计交货时间
atd
string <date-time>
实际交货时间
atp
string <date-time>
实际收货时间
etdPromised
string <date-time>
订单的承诺交货日期
etdByAs
string <date-time>
数据源预测的预计交货时间
pieces
string
件数
<= 8 字符
weight
string
重量
<= 12 字符
shipmentType
string
快递公司服务类型
<= 48 字符
signedBy
string
发货信息签字人
<= 18 字符
tag
string
当前状态代码
<= 18 字符
subTag
string
子状态代码
<= 24 字符
subTagMsg
string
子状态信息
<= 42 字符
trackCount
string
数据源该票请求次数
<= 3 字符
dtpSupport
string
货物是否支持跟踪到最终目的地
<= 1 字符
delType
string
货物交货类型
<= 18 字符
pickupStation
string
收货方的收货位置
<= 128 字符
pickupNote
string
收货备注
<= 84 字符
courierUrl
string
快递公司官网网址
<= 128 字符
courierModifyUrl
string
快递公司修改交货信息网址
<= 128 字符
onTimeStatus
string
准时状态
<= 24 字符
onTimeDif
string
准时的差异天数
<= 2 字符
nextSlug
string
下个承运商代码
<= 28 字符
nextTrackNo
string
下个承运商快递单号
<= 32 字符
endStatus
string
结束状态
<= 20 字符
trackStatus
string
跟踪状态
<= 20 字符
errorStatus
string
异常状态
<= 20 字符
errorMessage
string
异常备注
<= 255 字符
dataStatus
string
数据状态
<= 20 字符
billCreateTime
string <date-time>
运单订阅时间
firstUpdateTime
string <date-time>
首次获取到数据时间
dataUpdateTime
string <date-time>
数据更新时间
checkPoints
array [object {15}]
关键节点动态
示例
{
"code": 200,
"codeDesc": "success",
"message": "Operation succeeded",
"result": [
{
"id": "1927637103627579392",
"localKey": "",
"orgCode": "",
"customer": "",
"status": "S",
"errorDes": "",
"trackNo": "438784639952",
"slug": "fedex",
"slugGroup": "",
"language": "en",
"transitDays": "1",
"isActive": "Y",
"orgCountryCd": "CHN",
"orgState": "CN",
"orgCity": "JIANGSU",
"orgPostCd": "",
"org": "JIANGSU, CN, CN, China",
"dstCountryCd": "DEU",
"dstState": "",
"dstCity": "BREISACH",
"dstPostCd": "",
"dst": "BREISACH, DE, Germany",
"etd": "2025-06-02 18:00:00",
"atd": "",
"atp": "2025-05-28 14:37:00",
"etdPromised": "",
"etdByAs": "",
"pieces": "1",
"weight": "10.1 kg",
"shipmentType": "FedEx International Priority",
"signedBy": "",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"trackCount": "7",
"dtpSupport": "Y",
"delType": "",
"pickupStation": "",
"pickupNote": "",
"courierUrl": "https://www.fedex.com/apps/fedextrack/?tracknumbers=438784639952&cntry_code=US",
"courierModifyUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=438784639952&cntry_code=US",
"onTimeStatus": "trending-on-time",
"onTimeDif": "0",
"nextSlug": "",
"nextTrackNo": "",
"endStatus": "",
"trackStatus": "T",
"errorStatus": "",
"errorMessage": "",
"dataStatus": "Y",
"billCreateTime": "2025-05-28 16:04:33",
"firstUpdateTime": "2025-05-28 17:47:48",
"dataUpdateTime": "2025-05-29 08:45:15",
"checkPoints": [
{
"sno": 1,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "",
"state": "",
"city": "",
"postCd": "",
"station": "",
"checkPointTime": "2025-05-27 21:07:26",
"tag": "InfoReceived",
"subTag": "InfoReceived_001",
"subTagMsg": "Info Received",
"rawTag": "OC",
"messageCn": "",
"messageEn": "Shipment information sent to FedEx"
},
{
"sno": 2,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SUZHOU",
"postCd": "215128",
"station": "SUZHOU, 215128, CN, China",
"checkPointTime": "2025-05-28 14:37:00",
"tag": "InTransit",
"subTag": "InTransit_002",
"subTagMsg": "Acceptance scan",
"rawTag": "PU",
"messageCn": "",
"messageEn": "Picked up - Package received after FedEx cutoff"
},
{
"sno": 3,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SUZHOU",
"postCd": "215128",
"station": "SUZHOU, 215128, CN, China",
"checkPointTime": "2025-05-28 14:52:00",
"tag": "InTransit",
"subTag": "InTransit_007",
"subTagMsg": "Departure Scan",
"rawTag": "DP",
"messageCn": "",
"messageEn": "Left FedEx origin facility"
},
{
"sno": 4,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SHANGHAI",
"postCd": "201207",
"station": "SHANGHAI, 201207, CN, China",
"checkPointTime": "2025-05-28 18:58:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "CC",
"messageCn": "",
"messageEn": "International shipment release - Export"
},
{
"sno": 5,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SHANGHAI",
"postCd": "201207",
"station": "SHANGHAI, 201207, CN, China",
"checkPointTime": "2025-05-28 19:26:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "IT",
"messageCn": "",
"messageEn": "On the way"
},
{
"sno": 6,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SHANGHAI",
"postCd": "201207",
"station": "SHANGHAI, 201207, CN, China",
"checkPointTime": "2025-05-28 20:13:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "CC",
"messageCn": "",
"messageEn": "International shipment release - Export"
},
{
"sno": 7,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SHANGHAI",
"postCd": "201207",
"station": "SHANGHAI, 201207, CN, China",
"checkPointTime": "2025-05-28 20:16:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "IT",
"messageCn": "",
"messageEn": "On the way"
},
{
"sno": 8,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "CHN",
"state": "",
"city": "SHANGHAI",
"postCd": "201207",
"station": "SHANGHAI, 201207, CN, China",
"checkPointTime": "2025-05-28 20:59:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "IT",
"messageCn": "",
"messageEn": "On the way"
},
{
"sno": 9,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "JPN",
"state": "",
"city": "SENNAN-SHI",
"postCd": "54900",
"station": "SENNAN-SHI, 54900, JP, Japan",
"checkPointTime": "2025-05-29 01:34:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "IT",
"messageCn": "",
"messageEn": "On the way"
},
{
"sno": 10,
"trackNo": "438784639952",
"slug": "fedex",
"countryCd": "HKG",
"state": "",
"city": "CHEK LAP KOK",
"postCd": "300",
"station": "CHEK LAP KOK, 300, HK, Hong Kong",
"checkPointTime": "2025-05-29 06:45:00",
"tag": "InTransit",
"subTag": "InTransit_001",
"subTagMsg": "In Transit",
"rawTag": "IT",
"messageCn": "",
"messageEn": "On the way"
}
]
},
{
"id": "1927614365332508672",
"localKey": "",
"orgCode": "",
"customer": "",
"status": "S",
"errorDes": "",
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"slugGroup": "",
"language": "en",
"transitDays": "2",
"isActive": "Y",
"orgCountryCd": "CHN",
"orgState": "",
"orgCity": "SUZHOU",
"orgPostCd": "215021",
"org": "SUZHOU, 215021, CN, China",
"dstCountryCd": "TWN",
"dstState": "",
"dstCity": "TAOYUAN",
"dstPostCd": "32542",
"dst": "TAOYUAN, 32542, TW, Taiwan",
"etd": "2025-05-29 23:59:00",
"atd": "",
"atp": "2025-05-27 14:37:00",
"etdPromised": "",
"etdByAs": "",
"pieces": "",
"weight": "9.3 kg",
"shipmentType": "UPS Worldwide Express Saver",
"signedBy": "",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"trackCount": "14",
"dtpSupport": "Y",
"delType": "",
"pickupStation": "",
"pickupNote": "",
"courierUrl": "https://www.ups.com/track?loc=zh_tw&requester=QUIC&tracknum=1ZRX56750453545215/trackdetails",
"courierModifyUrl": "https://www.ups.com/track?loc=zh_tw&requester=QUIC&tracknum=1ZRX56750453545215/trackdetails",
"onTimeStatus": "trending-on-time",
"onTimeDif": "0",
"nextSlug": "",
"nextTrackNo": "",
"endStatus": "",
"trackStatus": "T",
"errorStatus": "",
"errorMessage": "",
"dataStatus": "Y",
"billCreateTime": "2025-05-28 14:34:12",
"firstUpdateTime": "2025-05-28 22:15:20",
"dataUpdateTime": "2025-05-29 07:15:24",
"checkPoints": [
{
"sno": 1,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "",
"postCd": "",
"station": "CN, China",
"checkPointTime": "2025-05-27 12:12:32",
"tag": "InfoReceived",
"subTag": "InfoReceived_001",
"subTagMsg": "Info Received",
"rawTag": "MP",
"messageCn": "",
"messageEn": "Shipper created a label, UPS has not received the package yet."
},
{
"sno": 2,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Suzhou",
"postCd": "",
"station": "Suzhou, CN, China",
"checkPointTime": "2025-05-27 14:37:00",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "OR",
"messageCn": "",
"messageEn": "Arrived at Facility"
},
{
"sno": 3,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Suzhou",
"postCd": "",
"station": "Suzhou, CN, China",
"checkPointTime": "2025-05-27 15:40:00",
"tag": "InTransit",
"subTag": "InTransit_007",
"subTagMsg": "Departure Scan",
"rawTag": "DP",
"messageCn": "",
"messageEn": "Departed from Facility"
},
{
"sno": 4,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Shanghai",
"postCd": "",
"station": "Shanghai, CN, China",
"checkPointTime": "2025-05-27 16:40:00",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "AR",
"messageCn": "",
"messageEn": "Arrived at Facility"
},
{
"sno": 5,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Shanghai",
"postCd": "",
"station": "Shanghai, CN, China",
"checkPointTime": "2025-05-28 01:15:38",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "EP",
"messageCn": "",
"messageEn": "Export Scan"
},
{
"sno": 6,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Shanghai",
"postCd": "",
"station": "Shanghai, CN, China",
"checkPointTime": "2025-05-28 07:07:00",
"tag": "InTransit",
"subTag": "InTransit_007",
"subTagMsg": "Departure Scan",
"rawTag": "DP",
"messageCn": "",
"messageEn": "Departed from Facility"
},
{
"sno": 7,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "KOR",
"state": "",
"city": "Incheon",
"postCd": "",
"station": "Incheon, KR, Korea, Republic Of",
"checkPointTime": "2025-05-28 09:51:00",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "AR",
"messageCn": "",
"messageEn": "Arrived at Facility"
},
{
"sno": 8,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "KOR",
"state": "",
"city": "Incheon",
"postCd": "",
"station": "Incheon, KR, Korea, Republic Of",
"checkPointTime": "2025-05-28 21:41:00",
"tag": "InTransit",
"subTag": "InTransit_007",
"subTagMsg": "Departure Scan",
"rawTag": "DP",
"messageCn": "",
"messageEn": "Departed from Facility"
},
{
"sno": 9,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "KOR",
"state": "",
"city": "Incheon",
"postCd": "",
"station": "Incheon, KR, Korea, Republic Of",
"checkPointTime": "2025-05-28 22:40:00",
"tag": "InTransit",
"subTag": "InTransit_007",
"subTagMsg": "Departure Scan",
"rawTag": "DP",
"messageCn": "",
"messageEn": "Departed from Facility"
},
{
"sno": 10,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Shenzhen",
"postCd": "",
"station": "Shenzhen, CN, China",
"checkPointTime": "2025-05-29 00:51:00",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "AR",
"messageCn": "",
"messageEn": "Arrived at Facility"
},
{
"sno": 11,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "CHN",
"state": "",
"city": "Shenzhen",
"postCd": "",
"station": "Shenzhen, CN, China",
"checkPointTime": "2025-05-29 04:23:00",
"tag": "InTransit",
"subTag": "InTransit_007",
"subTagMsg": "Departure Scan",
"rawTag": "DP",
"messageCn": "",
"messageEn": "Departed from Facility"
},
{
"sno": 12,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "TWN",
"state": "",
"city": "Taoyuan",
"postCd": "",
"station": "Taoyuan, TW, Taiwan",
"checkPointTime": "2025-05-29 06:25:00",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "AR",
"messageCn": "",
"messageEn": "Arrived at Facility"
},
{
"sno": 13,
"trackNo": "1ZRX56750453545215",
"slug": "ups",
"countryCd": "TWN",
"state": "",
"city": "Taoyuan",
"postCd": "",
"station": "Taoyuan, TW, Taiwan",
"checkPointTime": "2025-05-29 06:55:02",
"tag": "InTransit",
"subTag": "InTransit_003",
"subTagMsg": "Arrival scan",
"rawTag": "IP",
"messageCn": "",
"messageEn": "Import Scan"
}
]
}
]
}