推送运单动态接口

*API地址是需要贵司提供的，谢谢！（当动态有变化的时候都会调用贵司接口将最新的动态进行推送）

请求参数

Body 参数application/json

string <uuid>

运单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 字符

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 字符

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": 634286762385477,
    "deliveryNo": "",
    "orderNo": "",
    "localKey": "",
    "orgCode": "",
    "customer": "",
    "extendNo": "",
    "awbNo": "02019428765",
    "referenceNo": "020-19428765",
    "carrierCd": "LH",
    "carrier": "",
    "flightNo": "",
    "orgCd": "PEK",
    "org": "PEK (Beijing)",
    "destCd": "KTW",
    "dest": "KTW (Katowice)",
    "atd": "",
    "etd": "2025/1/24 5:25:00",
    "ata": "",
    "eta": "2025/1/27 6:00:00",
    "endTrackTime": "",
    "currentStatusCd": "BKD",
    "currentStatus": "",
    "currentStatusTime": "2025/1/22 15:29:00",
    "currentPlaceCd": "",
    "currentPlace": "PEK (Beijing)",
    "firstETA": "",
    "trackStatus": "B",
    "endStatus": "",
    "errorStatus": "",
    "errorMessage": "",
    "dataStatus": "Y",
    "endId": 0,
    "serviceType": "",
    "airFlightInfo": [
      {
        "sno": 1,
        "flightNo": "LH8431",
        "flightDate": "2025/1/24 0:00:00",
        "org": "PEK (Beijing)",
        "orgCd": "PEK",
        "dest": "FRA (Frankfurt)",
        "destCd": "FRA",
        "etd": "2025/1/24 5:25:00",
        "eta": "2025/1/24 11:05:00",
        "atd": "",
        "ata": "",
        "pieces": "5",
        "weight": "129",
        "volume": ""
      },
      {
        "sno": 2,
        "flightNo": "LH7422S",
        "flightDate": "2025/1/26 0:00:00",
        "org": "FRA (Frankfurt)",
        "orgCd": "FRA",
        "dest": "KTW (Katowice)",
        "destCd": "KTW",
        "etd": "2025/1/26 17:10:00",
        "eta": "2025/1/27 6:00:00",
        "atd": "",
        "ata": "",
        "pieces": "5",
        "weight": "129",
        "volume": ""
      }
    ],
    "airStatusInfo": [
      {
        "sno": 2,
        "statusCd": "RCS",
        "statusDesc": "进仓",
        "statusDescEn": "Shipment accepted",
        "flightNo": "",
        "eventTime": "2025/1/23 23:25:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 10,
        "statusCd": "RCF",
        "statusDesc": "卸货",
        "statusDescEn": "Received from flight",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/27 11:40:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 6,
        "statusCd": "TRF",
        "statusDesc": "中转卸货",
        "statusDescEn": "Received from flight",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 16:05:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 7,
        "statusCd": "MAN",
        "statusDesc": "配载",
        "statusDescEn": "Manifested",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/26 15:58:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 11,
        "statusCd": "NFD",
        "statusDesc": "到货通知",
        "statusDescEn": "Ready for pick-up",
        "flightNo": "",
        "eventTime": "2025/1/27 12:00:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 4,
        "statusCd": "DEP",
        "statusDesc": "起飞",
        "statusDescEn": "Departed",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 5:25:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 8,
        "statusCd": "TDE",
        "statusDesc": "中转起飞",
        "statusDescEn": "Departed",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/26 17:10:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 9,
        "statusCd": "ARR",
        "statusDesc": "抵达",
        "statusDescEn": "Arrived",
        "flightNo": "LH7422S",
        "eventTime": "2025/1/27 6:00:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 3,
        "statusCd": "MAN",
        "statusDesc": "配载",
        "statusDescEn": "Manifested",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 5:19:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 1,
        "statusCd": "BKD",
        "statusDesc": "订舱",
        "statusDescEn": "Booking  confirmed ",
        "flightNo": "",
        "eventTime": "2025/1/22 15:29:00",
        "place": "PEK (Beijing)",
        "placeCd": "PEK",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": false,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 5,
        "statusCd": "TAR",
        "statusDesc": "中转抵达",
        "statusDescEn": "Arrived",
        "flightNo": "LH8431",
        "eventTime": "2025/1/24 11:05:00",
        "place": "FRA (Frankfurt)",
        "placeCd": "FRA",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      },
      {
        "sno": 12,
        "statusCd": "DLV",
        "statusDesc": "提货",
        "statusDescEn": "Delivered",
        "flightNo": "",
        "eventTime": "2025/1/27 12:00:00",
        "place": "KTW (Katowice)",
        "placeCd": "KTW",
        "transportMode": "",
        "pieces": "5",
        "weight": "129",
        "volume": "",
        "isEstimate": true,
        "dateUpdateTime": "2025-01-23T15:26:09.252"
      }
    ]
  }
]

示例代码

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": 634286762385477,
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "extendNo": "",
        "awbNo": "02019428765",
        "referenceNo": "020-19428765",
        "carrierCd": "LH",
        "carrier": "",
        "flightNo": "",
        "orgCd": "PEK",
        "org": "PEK (Beijing)",
        "destCd": "KTW",
        "dest": "KTW (Katowice)",
        "atd": "",
        "etd": "2025/1/24 5:25:00",
        "ata": "",
        "eta": "2025/1/27 6:00:00",
        "endTrackTime": "",
        "currentStatusCd": "BKD",
        "currentStatus": "",
        "currentStatusTime": "2025/1/22 15:29:00",
        "currentPlaceCd": "",
        "currentPlace": "PEK (Beijing)",
        "firstETA": "",
        "trackStatus": "B",
        "endStatus": "",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "endId": 0,
        "serviceType": "",
        "airFlightInfo": [
            {
                "sno": 1,
                "flightNo": "LH8431",
                "flightDate": "2025/1/24 0:00:00",
                "org": "PEK (Beijing)",
                "orgCd": "PEK",
                "dest": "FRA (Frankfurt)",
                "destCd": "FRA",
                "etd": "2025/1/24 5:25:00",
                "eta": "2025/1/24 11:05:00",
                "atd": "",
                "ata": "",
                "pieces": "5",
                "weight": "129",
                "volume": ""
            },
            {
                "sno": 2,
                "flightNo": "LH7422S",
                "flightDate": "2025/1/26 0:00:00",
                "org": "FRA (Frankfurt)",
                "orgCd": "FRA",
                "dest": "KTW (Katowice)",
                "destCd": "KTW",
                "etd": "2025/1/26 17:10:00",
                "eta": "2025/1/27 6:00:00",
                "atd": "",
                "ata": "",
                "pieces": "5",
                "weight": "129",
                "volume": ""
            }
        ],
        "airStatusInfo": [
            {
                "sno": 2,
                "statusCd": "RCS",
                "statusDesc": "进仓",
                "statusDescEn": "Shipment accepted",
                "flightNo": "",
                "eventTime": "2025/1/23 23:25:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 10,
                "statusCd": "RCF",
                "statusDesc": "卸货",
                "statusDescEn": "Received from flight",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/27 11:40:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 6,
                "statusCd": "TRF",
                "statusDesc": "中转卸货",
                "statusDescEn": "Received from flight",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 16:05:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 7,
                "statusCd": "MAN",
                "statusDesc": "配载",
                "statusDescEn": "Manifested",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/26 15:58:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 11,
                "statusCd": "NFD",
                "statusDesc": "到货通知",
                "statusDescEn": "Ready for pick-up",
                "flightNo": "",
                "eventTime": "2025/1/27 12:00:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 4,
                "statusCd": "DEP",
                "statusDesc": "起飞",
                "statusDescEn": "Departed",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 5:25:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 8,
                "statusCd": "TDE",
                "statusDesc": "中转起飞",
                "statusDescEn": "Departed",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/26 17:10:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 9,
                "statusCd": "ARR",
                "statusDesc": "抵达",
                "statusDescEn": "Arrived",
                "flightNo": "LH7422S",
                "eventTime": "2025/1/27 6:00:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 3,
                "statusCd": "MAN",
                "statusDesc": "配载",
                "statusDescEn": "Manifested",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 5:19:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 1,
                "statusCd": "BKD",
                "statusDesc": "订舱",
                "statusDescEn": "Booking  confirmed ",
                "flightNo": "",
                "eventTime": "2025/1/22 15:29:00",
                "place": "PEK (Beijing)",
                "placeCd": "PEK",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": false,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 5,
                "statusCd": "TAR",
                "statusDesc": "中转抵达",
                "statusDescEn": "Arrived",
                "flightNo": "LH8431",
                "eventTime": "2025/1/24 11:05:00",
                "place": "FRA (Frankfurt)",
                "placeCd": "FRA",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            },
            {
                "sno": 12,
                "statusCd": "DLV",
                "statusDesc": "提货",
                "statusDescEn": "Delivered",
                "flightNo": "",
                "eventTime": "2025/1/27 12:00:00",
                "place": "KTW (Katowice)",
                "placeCd": "KTW",
                "transportMode": "",
                "pieces": "5",
                "weight": "129",
                "volume": "",
                "isEstimate": true,
                "dateUpdateTime": "2025-01-23T15:26:09.252"
            }
        ]
    }
]'

application/json

Body

code

integer

推送状态

必需

200=成功，其他=失败

message

string

描述信息

必需

示例

{
  "code": 200,
  "message": "success"
}

请求参数

示例代码

返回响应