推送运单动态接口 - Trackingeyes数据接口

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

请求参数

Body 参数application/json

integer

运单id

必需

订阅接口返回的运单id

deliveryNo

string

交货单号

可选

<= 38 字符

orderNo

string

需货单号

可选

<= 600 字符

localKey

string

客户本地关键字

可选

<= 38 字符

orgCode

string

所属组织代码

可选

<= 64 字符

customer

string

客户

可选

<= 128 字符

extendNo

string

扩展字段json

可选

长度不定，暂未开放使用

awbNo

string

空运主单号

可选

<= 32 字符

referenceNo

string

客户订阅号

必需

空运单号

<= 32 字符

carrierCd

string

航司代码

必需

<= 16 字符

carrier

string

航司简称

可选

<= 16 字符

status

string

订阅状态

可选

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

<= 10 字符

errorDes

string

订阅失败信息

可选

<= 255 字符

pieces

string

总件数

可选

字符串内容是整型数字数据

weight

string

总重量

可选

字符串内容是12位长度带3位小数

volume

string

总体积

可选

字符串内容是12位长度带3位小数

flightNo

string

航班编号

可选

<= 32 字符

orgCd

string

起飞地代码

可选

<= 8 字符

org

string

起飞地名称

可选

<= 128 字符

destCd

string

目的地代码

可选

<= 8 字符

dest

string

目的地名称

可选

<= 128 字符

atd

string <date-time>

实际起飞时间

可选

etd

string <date-time>

预计起飞时间

可选

ata

string <date-time>

实际抵达时间

可选

eta

string <date-time>

预计抵达时间

可选

endTrackTime

string <date-time>

结束时间

可选

currentStatusCd

string

当前状态代码

可选

<= 12 字符

currentStatus

string

当前状态

可选

<= 16 字符

currentStatusTime

string <date-time>

当前状态时间

可选

currentPlaceCd

string

当前地点代码

可选

<= 128 字符

currentPlace

string

当前地点名称

可选

<= 128 字符

firstEta

string <date-time>

起飞后第一次获取到的预计抵达时间

可选

trackStatus

string

跟踪状态

可选

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

<= 20 字符

endId

integer

结束状态唯一标志

可选

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

endStatus

string

结束状态

可选

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

<= 20 字符

errorStatus

string

异常状态

可选

T=提示、E=错误，空值

<= 10 字符

errorMessage

string

异常备注

可选

<= 255 字符

dataStatus

string

数据状态

可选

Y=有数据，B=航司无数据，空值

<= 20 字符

serviceType

string

服务类型

可选

暂未开放使用

<= 64 字符

billCreateTime

string <date-time>

运单订阅时间

可选

firstUpdateTime

string <date-time>

首次数据更新时间

可选

dataUpdateTime

string <date-time>

数据更新时间

可选

airFlightInfo

array [object {14}]

航班信息

可选

sno

integer

序号

必需

flightNo

string

航班编号

可选

<= 64 字符

flightDate

string <date-time>

航班日期

可选

org

string

始发站

可选

<= 128 字符

orgCd

string

始发站代码

可选

<= 8 字符

dest

string

目的站

可选

<= 128 字符

destCd

string

目的站代码

可选

<= 8 字符

etd

string <date-time>

预离时间

可选

eta

string <date-time>

预抵时间

可选

atd

string <date-time>

实际起飞时间

可选

ata

string <date-time>

实际抵达时间

可选

pieces

string

件数

可选

字符串内容是整型数字数据

weight

string

重量

可选

字符串内容是12位长度带3位小数

volume

string

体积

可选

字符串内容是12位长度带3位小数

airStatusInfo

array [object {14}]

空运动态信息

可选

sno

integer

序号

可选

statusCd

string

动态代码

可选

<= 12 字符

statusDesc

string

动态描述

可选

<= 255 字符

statusDescEn

string

动态英文描述

可选

<= 255 字符

flightNo

string

航班编号

可选

<= 64 字符

eventTime

string <date-time>

事件时间

可选

place

string

状态发生地名称

可选

<= 128 字符

placeCd

string

状态发生地代码

可选

<= 128 字符

transportMode

string

运输类型

可选

<= 36 字符

pieces

string

件数

可选

字符串内容是整型数字数据

weight

string

重量

可选

字符串内容是12位长度带3位小数

volume

string

体积

可选

字符串内容是12位长度带3位小数

isEstimate

boolean

是否预计

可选

（true=预计，false=实际）

dateUpdateTime

string <date-time>

数据更新时间

可选

示例

[
    {
        "id": 19300000000000000,
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "awbNo": "18041272512",
        "referenceNo": "180-41272512",
        "carrierCd": "KE",
        "carrier": "大韩航空",
        "status": "S",
        "errorDes": "",
        "pieces": "1",
        "weight": "117",
        "volume": "",
        "flightNo": "",
        "orgCd": "TSN",
        "org": "TSN",
        "destCd": "SEA",
        "dest": "SEA",
        "atd": "2025-06-26 15:26:00",
        "etd": "2025-06-26 16:00:00",
        "ata": "2025-06-27 11:16:00",
        "eta": "2025-06-27 10:50:00",
        "endTrackTime": "2025-06-28 14:41:00",
        "currentStatusCd": "End",
        "currentStatus": "结束跟踪",
        "currentStatusTime": "2025-06-28 14:41:00",
        "currentPlaceCd": "",
        "currentPlace": "SEA",
        "firstEta": "2025-06-27 10:50:00",
        "trackStatus": "E",
        "endId": 19300000000000000,
        "endStatus": "E",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "serviceType": "",
        "billCreateTime": "2025-07-01 15:09:46",
        "firstUpdateTime": "2025-07-01 15:09:59",
        "dataUpdateTime": "2025-07-03 11:12:16",
        "airFlightInfo": [
            {
                "sno": 1,
                "flightNo": "KE0318D",
                "flightDate": "2025-06-26 00:00:00",
                "org": "TSN",
                "orgCd": "TSN",
                "dest": "ICN",
                "destCd": "ICN",
                "etd": "2025-06-26 16:00:00",
                "eta": "2025-06-26 18:40:00",
                "atd": "2025-06-26 15:26:00",
                "ata": "2025-06-26 18:10:00",
                "pieces": "1",
                "weight": "117",
                "volume": ""
            },
            {
                "sno": 2,
                "flightNo": "KE0041",
                "flightDate": "2025-06-27 00:00:00",
                "org": "ICN",
                "orgCd": "ICN",
                "dest": "SEA",
                "destCd": "SEA",
                "etd": "2025-06-27 16:40:00",
                "eta": "2025-06-27 10:50:00",
                "atd": "2025-06-27 17:20:00",
                "ata": "2025-06-27 11:16:00",
                "pieces": "1",
                "weight": "117",
                "volume": ""
            }
        ],
        "airStatusInfo": [
            {
                "sno": 13,
                "statusCd": "RCF",
                "statusDesc": "卸货",
                "statusDescEn": "Arrived at Terminal",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 11:17:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 10,
                "statusCd": "TDE",
                "statusDesc": "中转起飞",
                "statusDescEn": "Departed",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 17:20:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 3,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booked",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 08:42:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "100",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 15,
                "statusCd": "DLV",
                "statusDesc": "提货",
                "statusDescEn": "Cargo Delivered",
                "flightNo": "KE0041",
                "eventTime": "2025-06-28 14:41:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 12,
                "statusCd": "NFD",
                "statusDesc": "到货通知",
                "statusDescEn": "Consignee Notified",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 11:17:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 4,
                "statusCd": "",
                "statusDesc": "Freight on Hand",
                "statusDescEn": "Freight on Hand",
                "flightNo": "",
                "eventTime": "2025-06-26 12:18:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 1,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booked",
                "flightNo": "KE0318",
                "eventTime": "2025-06-20 17:46:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "100",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 6,
                "statusCd": "DEP",
                "statusDesc": "起飞",
                "statusDescEn": "Departed",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 15:26:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 7,
                "statusCd": "TAR",
                "statusDesc": "中转抵达",
                "statusDescEn": "Arrived",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 18:10:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 14,
                "statusCd": "NFD",
                "statusDesc": "到货通知",
                "statusDescEn": "Consignee Notified",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 12:51:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 11,
                "statusCd": "ARR",
                "statusDesc": "抵达",
                "statusDescEn": "Arrived",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 11:16:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 9,
                "statusCd": "TRF",
                "statusDesc": "中转卸货",
                "statusDescEn": "Arrived at Terminal",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 19:01:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 8,
                "statusCd": "",
                "statusDesc": "Consignee Notified",
                "statusDescEn": "Consignee Notified",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 19:01:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 5,
                "statusCd": "RCS",
                "statusDesc": "收货",
                "statusDescEn": "Received",
                "flightNo": "",
                "eventTime": "2025-06-26 12:22:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 2,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booked",
                "flightNo": "KE0041",
                "eventTime": "2025-06-20 17:46:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "100",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            }
        ]
    }
]

示例代码

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": 19300000000000000,
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "awbNo": "18041272512",
        "referenceNo": "180-41272512",
        "carrierCd": "KE",
        "carrier": "大韩航空",
        "status": "S",
        "errorDes": "",
        "pieces": "1",
        "weight": "117",
        "volume": "",
        "flightNo": "",
        "orgCd": "TSN",
        "org": "TSN",
        "destCd": "SEA",
        "dest": "SEA",
        "atd": "2025-06-26 15:26:00",
        "etd": "2025-06-26 16:00:00",
        "ata": "2025-06-27 11:16:00",
        "eta": "2025-06-27 10:50:00",
        "endTrackTime": "2025-06-28 14:41:00",
        "currentStatusCd": "End",
        "currentStatus": "结束跟踪",
        "currentStatusTime": "2025-06-28 14:41:00",
        "currentPlaceCd": "",
        "currentPlace": "SEA",
        "firstEta": "2025-06-27 10:50:00",
        "trackStatus": "E",
        "endId": 19300000000000000,
        "endStatus": "E",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "serviceType": "",
        "billCreateTime": "2025-07-01 15:09:46",
        "firstUpdateTime": "2025-07-01 15:09:59",
        "dataUpdateTime": "2025-07-03 11:12:16",
        "airFlightInfo": [
            {
                "sno": 1,
                "flightNo": "KE0318D",
                "flightDate": "2025-06-26 00:00:00",
                "org": "TSN",
                "orgCd": "TSN",
                "dest": "ICN",
                "destCd": "ICN",
                "etd": "2025-06-26 16:00:00",
                "eta": "2025-06-26 18:40:00",
                "atd": "2025-06-26 15:26:00",
                "ata": "2025-06-26 18:10:00",
                "pieces": "1",
                "weight": "117",
                "volume": ""
            },
            {
                "sno": 2,
                "flightNo": "KE0041",
                "flightDate": "2025-06-27 00:00:00",
                "org": "ICN",
                "orgCd": "ICN",
                "dest": "SEA",
                "destCd": "SEA",
                "etd": "2025-06-27 16:40:00",
                "eta": "2025-06-27 10:50:00",
                "atd": "2025-06-27 17:20:00",
                "ata": "2025-06-27 11:16:00",
                "pieces": "1",
                "weight": "117",
                "volume": ""
            }
        ],
        "airStatusInfo": [
            {
                "sno": 13,
                "statusCd": "RCF",
                "statusDesc": "卸货",
                "statusDescEn": "Arrived at Terminal",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 11:17:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 10,
                "statusCd": "TDE",
                "statusDesc": "中转起飞",
                "statusDescEn": "Departed",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 17:20:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 3,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booked",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 08:42:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "100",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 15,
                "statusCd": "DLV",
                "statusDesc": "提货",
                "statusDescEn": "Cargo Delivered",
                "flightNo": "KE0041",
                "eventTime": "2025-06-28 14:41:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 12,
                "statusCd": "NFD",
                "statusDesc": "到货通知",
                "statusDescEn": "Consignee Notified",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 11:17:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 4,
                "statusCd": "",
                "statusDesc": "Freight on Hand",
                "statusDescEn": "Freight on Hand",
                "flightNo": "",
                "eventTime": "2025-06-26 12:18:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 1,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booked",
                "flightNo": "KE0318",
                "eventTime": "2025-06-20 17:46:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "100",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 6,
                "statusCd": "DEP",
                "statusDesc": "起飞",
                "statusDescEn": "Departed",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 15:26:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 7,
                "statusCd": "TAR",
                "statusDesc": "中转抵达",
                "statusDescEn": "Arrived",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 18:10:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 14,
                "statusCd": "NFD",
                "statusDesc": "到货通知",
                "statusDescEn": "Consignee Notified",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 12:51:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 11,
                "statusCd": "ARR",
                "statusDesc": "抵达",
                "statusDescEn": "Arrived",
                "flightNo": "KE0041",
                "eventTime": "2025-06-27 11:16:00",
                "place": "SEA",
                "placeCd": "SEA",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 9,
                "statusCd": "TRF",
                "statusDesc": "中转卸货",
                "statusDescEn": "Arrived at Terminal",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 19:01:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 8,
                "statusCd": "",
                "statusDesc": "Consignee Notified",
                "statusDescEn": "Consignee Notified",
                "flightNo": "KE0318D",
                "eventTime": "2025-06-26 19:01:00",
                "place": "ICN",
                "placeCd": "ICN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 5,
                "statusCd": "RCS",
                "statusDesc": "收货",
                "statusDescEn": "Received",
                "flightNo": "",
                "eventTime": "2025-06-26 12:22:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "117",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            },
            {
                "sno": 2,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booked",
                "flightNo": "KE0041",
                "eventTime": "2025-06-20 17:46:00",
                "place": "TSN",
                "placeCd": "TSN",
                "transportMode": "",
                "pieces": "1",
                "weight": "100",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-07-03 11:17:03"
            }
        ]
    }
]'

返回响应

🟢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"
}