港区数据推送接口 - Trackingeyes数据接口

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

请求参数

Body 参数application/json

array of:

integer

运单id

必需

订阅接口返回的运单id

referenceNo

string

订阅单号

必需

<= 32 字符

portNo

string

订阅号

必需

<= 32 字符

blType

enum<string>

订阅类型

必需

BL=提单号/CN=箱号

<= 32 字符

枚举值:

BLCN

portCd

string

港口代码

必需

<= 8 字符

ieid

enum<string>

进出口标识

必需

I=进口，E=出口

<= 2 字符

枚举值:

localKey

string

客户本地关键字

可选

<= 38 字符

customerService

string

商服姓名

可选

多个以英文;隔开

<= 128 字符

orgCode

string

所属组织代码

可选

<= 64 字符

extendNo

string

拓展字段Json

可选

长度由具体数据决定，暂未使用

<= 255 字符

remark

string

备注

可选

<= 255 字符

status

string

订阅状态

可选

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

<= 10 字符

errorDes

string

订阅失败信息

可选

<= 255 字符

billCreateTime

string <date-time>

运单订阅时间

可选

dataUpdateTime

string <date-time>

数据更新时间

可选

firstUpdateTime

string <date-time>

首次数据更新时间

可选

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

ctnrInfos

array [object {53}]

可选

blNo

string

提单号

可选

<= 36 字符

ctnrNo

string

箱号

可选

<= 11 字符

owner

string

箱主/属

可选

<= 64 字符

vslName

string

船名

可选

<= 64 字符

voy

string

航次

可选

<= 32 字符

ieid

string

进出口标识

可选

I=进口，E=出口

<= 2 字符

csize

string

尺寸

可选

<= 2 字符

ctype

string

箱型

可选

<= 4 字符

terminalCd

string

码头代码

可选

<= 18 字符

terminal

string

码头名称

可选

<= 64 字符

portCd

string

码头所属港口代码

可选

<= 18 字符

slot

string

场箱位

可选

<= 64 字符

sealNo

string

封签号

可选

<= 36 字符

customStatus

string

海放标识

可选

Y=已放行，N或空=未放行

<= 1 字符

customTime

string <date-time>

海放时间

可选

terminalRLSStatus

string

码放标识

可选

Y=已放行，N或空=未放行

<= 1 字符

terminalRLSTime

string <date-time>

码放时间

可选

inspectionStatus

string

国检放行标识

可选

Y=已放行，N或空=未放行

<= 1 字符

inspectionTime

string <date-time>

国检放行时间

可选

ifCI

string

是否查验

可选

Y=是，N或空=否

<= 1 字符

citime

string <date-time>

查验时间

可选

dgid

string

危品标识

可选

Y=危险品

<= 1 字符

dglevel

string

危品等级

可选

<= 5 字符

dgunNo

string

危品国际编号

可选

<= 10 字符

rfid

string

冻柜标识

可选

Y=冻柜

<= 1 字符

rftmp

string

冷藏温度

可选

<= 56 字符

poundWgt

string

磅重

可选

<= 11 字符

vgm

string

VGM重量

可选

<= 11 字符

tareWgt

string

箱皮重

可选

<= 11 字符

pieces

string

件数

可选

<= 18 字符

grossWgt

string

毛重

可选

<= 18 字符

volume

string

体积

可选

<= 18 字符

pol

string

起运港

可选

<= 64 字符

pod

string

卸货港

可选

<= 64 字符

inTime

string <date-time>

进场时间

可选

outTime

string <date-time>

出场时间

可选

preLoadId

string

配载标识

可选

Y=已配载

<= 2 字符

inType

string

进场方式

可选

<= 16 字符

outType

string

出场方式

可选

<= 16 字符

cntrDynamic

string

当前箱状态

可选

<= 18 字符

truckNo

string

拖车号

可选

<= 10 字符

efid

string

空重标识

可选

E=空箱，F=重箱

<= 2 字符

wharFRLStatus

string

码头扣留标识

可选

Y=是，N或空=否

<= 2 字符

number <double>

超高（CM）

可选

olid

string

超限标识

可选

Y=是，N=否

<= 2 字符

olf

number <double>

前超（CM）

可选

olb

number <double>

后超（CM）

可选

owl

number <double>

左超（CM）

可选

owr

number <double>

右超（CM）

可选

berthEta

string <date-time>

预计靠泊时间

可选

berthEtd

string <date-time>

预计离泊时间

可选

berthAta

string <date-time>

实际靠泊时间

可选

berthAtd

string <date-time>

实际离泊时间

可选

示例

[
    {
        "id": 1924301708608016400,
        "referenceNo": "HDUJSLX25KA00567",
        "portNo": "HDUJSLX25KA00567",
        "blType": "BL",
        "portCd": "CNSHA",
        "ieid": "E",
        "localKey": "",
        "customerService": "",
        "orgCode": "",
        "extendNo": "",
        "remark": "",
        "status": "S",
        "errorDes": "",
        "billCreateTime": "2025-05-19 11:10:53",
        "dataUpdateTime": "2025-05-19 11:10:58",
        "firstUpdateTime": "2025-05-19 11:10:58",
        "endStatus": "E",
        "endId": 1924301708637376500,
        "trackStatus": "E",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "ctnrInfos": [
            {
                "blNo": "HDUJSLX25KA00567",
                "ctnrNo": "SELU4217079",
                "owner": " HDW",
                "vslName": "ADONIS",
                "voy": "2505E",
                "ieid": "E",
                "csize": "40",
                "ctype": "HC",
                "terminalCd": "SHAMDMT",
                "terminal": "明东（外五）",
                "portCd": "CNSHA",
                "slot": "",
                "sealNo": "C665655",
                "customStatus": "Y",
                "customTime": "",
                "terminalRLSStatus": "Y",
                "terminalRLSTime": "",
                "inspectionStatus": "",
                "inspectionTime": "",
                "ifCI": "",
                "citime": "",
                "dgid": "",
                "dglevel": "",
                "dgunNo": "",
                "rfid": "",
                "rftmp": " ",
                "poundWgt": "17559",
                "vgm": "",
                "tareWgt": "3700",
                "pieces": "49",
                "grossWgt": "825.8",
                "volume": "4",
                "pol": "CNSHA",
                "pod": "USLA1",
                "inTime": "2025-05-19 11:07:02",
                "outTime": "2025-05-22 06:05:28",
                "preLoadId": "",
                "inType": "出口重箱进场",
                "outType": "装船出场",
                "cntrDynamic": "出口装船",
                "truckNo": "",
                "efid": "",
                "wharFRLStatus": "",
                "oh": 0,
                "olid": "",
                "olf": 0,
                "olb": 0,
                "owl": 0,
                "owr": 0,
                "berthEta": "2025-05-21 21:00:00",
                "berthEtd": "2025-05-22 22:00:00",
                "berthAta": "2025-05-21 21:30:00",
                "berthAtd": ""
            }
        ]
    }
]

示例代码

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": 1924301708608016400,
        "referenceNo": "HDUJSLX25KA00567",
        "portNo": "HDUJSLX25KA00567",
        "blType": "BL",
        "portCd": "CNSHA",
        "ieid": "E",
        "localKey": "",
        "customerService": "",
        "orgCode": "",
        "extendNo": "",
        "remark": "",
        "status": "S",
        "errorDes": "",
        "billCreateTime": "2025-05-19 11:10:53",
        "dataUpdateTime": "2025-05-19 11:10:58",
        "firstUpdateTime": "2025-05-19 11:10:58",
        "endStatus": "E",
        "endId": 1924301708637376500,
        "trackStatus": "E",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "ctnrInfos": [
            {
                "blNo": "HDUJSLX25KA00567",
                "ctnrNo": "SELU4217079",
                "owner": " HDW",
                "vslName": "ADONIS",
                "voy": "2505E",
                "ieid": "E",
                "csize": "40",
                "ctype": "HC",
                "terminalCd": "SHAMDMT",
                "terminal": "明东（外五）",
                "portCd": "CNSHA",
                "slot": "",
                "sealNo": "C665655",
                "customStatus": "Y",
                "customTime": "",
                "terminalRLSStatus": "Y",
                "terminalRLSTime": "",
                "inspectionStatus": "",
                "inspectionTime": "",
                "ifCI": "",
                "citime": "",
                "dgid": "",
                "dglevel": "",
                "dgunNo": "",
                "rfid": "",
                "rftmp": " ",
                "poundWgt": "17559",
                "vgm": "",
                "tareWgt": "3700",
                "pieces": "49",
                "grossWgt": "825.8",
                "volume": "4",
                "pol": "CNSHA",
                "pod": "USLA1",
                "inTime": "2025-05-19 11:07:02",
                "outTime": "2025-05-22 06:05:28",
                "preLoadId": "",
                "inType": "出口重箱进场",
                "outType": "装船出场",
                "cntrDynamic": "出口装船",
                "truckNo": "",
                "efid": "",
                "wharFRLStatus": "",
                "oh": 0,
                "olid": "",
                "olf": 0,
                "olb": 0,
                "owl": 0,
                "owr": 0,
                "berthEta": "2025-05-21 21:00:00",
                "berthEtd": "2025-05-22 22:00:00",
                "berthAta": "2025-05-21 21:30:00",
                "berthAtd": ""
            }
        ]
    }
]'

返回响应

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