快递数据推送接口 - Trackingeyes数据接口

1.请贵司提供接收推送数据的API地址，谢谢！
2.所有的时间字段都是字符串类型，格式为 "yyyy-MM-dd HH:mm:ss"，如果时间没有值则为空字符串""。

请求参数

Body 参数application/json

array of:

integer

运单Id

必需

订阅接口返回的运单Id

localKey

string

客户本地关键字

可选

<= 38 字符

orgCode

string

所属组织代码

可选

<= 64 字符

customer

string

客户

可选

<= 128 字符

extendNo

string

扩展字段json

可选

长度不定，暂未开放使用

status

string

订阅状态

可选

B=订阅中，S=订阅成功，F=订阅失败

<= 10 字符

errorDes

string

订阅失败信息

可选

<= 255 字符

trackNo

string

快递单号

可选

<= 32 字符

slug

string

快递承运商代码

可选

<= 28 字符

slugGroup

string

快递承运商集团代码

可选

<= 28 字符

language

string

动态描述语言

可选

en=英文，zh=中文

<= 2 字符

transitDays

string

运输天数

可选

<= 2 字符

isActive

string

活跃标志

可选

Y=快递还在流程中，N=已结束/已过期

<= 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

货物是否支持跟踪到最终目的地

可选

Y=是，N=否

<= 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

结束状态

可选

''=未结束,E=正常结束,EF=强制结束

<= 20 字符

endId

integer

结束标志

可选

0=未结束，其他=已结束；雪花id的Long类型，内部使用字段

trackStatus

string

跟踪状态

可选

T=跟踪中:E=跟踪结束:F=跟踪失败

<= 20 字符

errorStatus

string

异常状态

可选

T=提示，E=错误，空值=正常

<= 20 字符

errorMessage

string

异常备注

可选

<= 255 字符

dataStatus

string

数据状态

可选

Y=有数据，B=暂无数据,空值

<= 20 字符

billCreateTime

string <date-time>

运单订阅时间

可选

firstUpdateTime

string <date-time>

首次数据更新时间

可选

dataUpdateTime

string <date-time>

数据更新时间

可选

checkPoints

array [object {15}]

关键节点动态

可选

sno

integer

动态序号

可选

trackNo

string

快递单号

可选

<= 32 字符

slug

string

快递公司代码

可选

<= 28 字符

countryCd

string

动态地点国家/地区代码

可选

<= 3 字符

state

string

动态地点州/省

可选

<= 32 字符

city

string

动态地点城市

可选

<= 28 字符

postCd

string

动态地点邮政编码

可选

<= 10 字符

station

string

动态地点

可选

<= 128 字符

checkPointTime

string <date-time>

动态时间

可选

tag

string

当前状态代码

可选

<= 18 字符

subTag

string

子状态代码

可选

<= 24 字符

subTagMsg

string

子状态信息

可选

<= 42 字符

rawTag

string

承运商提供的状态代码

可选

<= 16 字符

messageCn

string

承运商提供的动态描述（中文）

可选

<= 400 字符

messageEn

string

承运商提供的动态描述（英文）

可选

<= 400 字符

示例

[
    {
        "id": 1927637327448223700,
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "status": "S",
        "errorDes": "",
        "trackNo": "1ZRX56750452242446",
        "slug": "ups",
        "slugGroup": "",
        "language": "en",
        "transitDays": "1",
        "isActive": "Y",
        "orgCountryCd": "CHN",
        "orgState": "",
        "orgCity": "SUZHOU",
        "orgPostCd": "215021",
        "org": "SUZHOU, 215021, CN, China",
        "dstCountryCd": "GBR",
        "dstState": "",
        "dstCity": "PETERSFIELD",
        "dstPostCd": "GU32 3QG",
        "dst": "PETERSFIELD, GU32 3QG, GB, United Kingdom",
        "etd": "2025-05-30 23:59:00",
        "atd": "",
        "atp": "2025-05-28 12:28:32",
        "etdPromised": "",
        "etdByAs": "",
        "pieces": "",
        "weight": "6.4 kg",
        "shipmentType": "UPS Worldwide Express Saver",
        "signedBy": "",
        "tag": "InTransit",
        "subTag": "InTransit_007",
        "subTagMsg": "Departure Scan",
        "trackCount": "8",
        "dtpSupport": "Y",
        "delType": "",
        "pickupStation": "",
        "pickupNote": "",
        "courierUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "courierModifyUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "onTimeStatus": "trending-on-time",
        "onTimeDif": "0",
        "nextSlug": "",
        "nextTrackNo": "",
        "endStatus": "",
        "endId": "0",
        "trackStatus": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2025-05-28 16:05:27",
        "firstUpdateTime": "2025-05-28 18:35:05",
        "dataUpdateTime": "2025-05-29 12:35:16",
        "checkPoints": [
            {
                "sno": 1,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "",
                "postCd": "",
                "station": "CN, China",
                "checkPointTime": "2025-05-28 12:02:05",
                "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": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 12:28:32",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "OR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 3,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 15:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 4,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-28 16:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 5,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 01:26:43",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "EP",
                "messageCn": "",
                "messageEn": "Export Scan"
            },
            {
                "sno": 6,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:03:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 7,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:17:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 8,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 08:55:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 9,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 11:20:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            }
        ]
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.trackingeyes.com' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "id": 1927637327448223700,
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "status": "S",
        "errorDes": "",
        "trackNo": "1ZRX56750452242446",
        "slug": "ups",
        "slugGroup": "",
        "language": "en",
        "transitDays": "1",
        "isActive": "Y",
        "orgCountryCd": "CHN",
        "orgState": "",
        "orgCity": "SUZHOU",
        "orgPostCd": "215021",
        "org": "SUZHOU, 215021, CN, China",
        "dstCountryCd": "GBR",
        "dstState": "",
        "dstCity": "PETERSFIELD",
        "dstPostCd": "GU32 3QG",
        "dst": "PETERSFIELD, GU32 3QG, GB, United Kingdom",
        "etd": "2025-05-30 23:59:00",
        "atd": "",
        "atp": "2025-05-28 12:28:32",
        "etdPromised": "",
        "etdByAs": "",
        "pieces": "",
        "weight": "6.4 kg",
        "shipmentType": "UPS Worldwide Express Saver",
        "signedBy": "",
        "tag": "InTransit",
        "subTag": "InTransit_007",
        "subTagMsg": "Departure Scan",
        "trackCount": "8",
        "dtpSupport": "Y",
        "delType": "",
        "pickupStation": "",
        "pickupNote": "",
        "courierUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "courierModifyUrl": "https://www.ups.com/track?loc=en_gb&requester=QUIC&tracknum=1ZRX56750452242446/trackdetails",
        "onTimeStatus": "trending-on-time",
        "onTimeDif": "0",
        "nextSlug": "",
        "nextTrackNo": "",
        "endStatus": "",
        "endId": "0",
        "trackStatus": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2025-05-28 16:05:27",
        "firstUpdateTime": "2025-05-28 18:35:05",
        "dataUpdateTime": "2025-05-29 12:35:16",
        "checkPoints": [
            {
                "sno": 1,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "",
                "postCd": "",
                "station": "CN, China",
                "checkPointTime": "2025-05-28 12:02:05",
                "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": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 12:28:32",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "OR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 3,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Suzhou",
                "postCd": "",
                "station": "Suzhou, CN, China",
                "checkPointTime": "2025-05-28 15:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 4,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-28 16:30:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 5,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 01:26:43",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "EP",
                "messageCn": "",
                "messageEn": "Export Scan"
            },
            {
                "sno": 6,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:03:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 7,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "CHN",
                "state": "",
                "city": "Shanghai",
                "postCd": "",
                "station": "Shanghai, CN, China",
                "checkPointTime": "2025-05-29 06:17:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            },
            {
                "sno": 8,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 08:55:00",
                "tag": "InTransit",
                "subTag": "InTransit_003",
                "subTagMsg": "Arrival scan",
                "rawTag": "AR",
                "messageCn": "",
                "messageEn": "Arrived at Facility"
            },
            {
                "sno": 9,
                "trackNo": "1ZRX56750452242446",
                "slug": "ups",
                "countryCd": "KOR",
                "state": "",
                "city": "Incheon",
                "postCd": "",
                "station": "Incheon, KR, Korea, Republic Of",
                "checkPointTime": "2025-05-29 11:20:00",
                "tag": "InTransit",
                "subTag": "InTransit_007",
                "subTagMsg": "Departure Scan",
                "rawTag": "DP",
                "messageCn": "",
                "messageEn": "Departed from Facility"
            }
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

200=成功

type

string

类型

必需

S=成功、W=警告、E=异常

message

string

错误信息

必需

time

string

时间

必需

示例

{
    "code": 200,
    "type": "S",
    "message": null,
    "time": "2023-12-13 01:20:38"
}