及时请求推送接口 - Trackingeyes数据接口

1.请贵司提供接收推送数据的API地址，谢谢！
2.推送仅返回及时请求获取到的数据。

请求参数

Body 参数application/json

code

integer

状态码

可选

200=成功，其他=失败

type

string

类型

可选

S=成功、E=异常、F=失败

<= 12 字符

message

string

错误信息

可选

data

array [object {31}]

可选

requestId

string

请求号

可选

<= 64 字符

batchId

string

批次号

可选

<= 64 字符

localKey

string

客户本地关键字

可选

<= 38 字符

blNo

string

提单号

可选

<= 128 字符

bkgNo

string

订舱号

可选

<= 128 字符

ctnrNo

string

箱号

可选

<= 11 字符

carrierCd

string

云当船东代码

可选

<= 18 字符

vesselName

string

起运港船名

可选

<= 64 字符

voyage

string

起运港航次

可选

<= 32 字符

plrCd

string

收货地代码

可选

<= 8 字符

plr

string

收货地名称

可选

<= 164 字符

polCd

string

起运港代码

可选

<= 8 字符

pol

string

起运港名称

可选

<= 164 字符

podCd

string

目的港代码

可选

<= 8 字符

pod

string

目的港名称

可选

<= 164 字符

pldCd

string

交货地代码

可选

<= 8 字符

pld

string

交货地名称

可选

<= 164 字符

cyOpenTime

string <date-time>

开港日期

可选

cyCutOffTime

string <date-time>

截港日期

可选

dlptTime

string <date-time>

实际离港（开航）时间

可选

etd

string <date-time>

预计离开起运港时间

可选

eta

string <date-time>

预计到达目的港时间

可选

ata

string <date-time>

实际抵达目的港时间

可选

etaPLD

string <date-time>

预计抵达交货地时间

可选

ataPLD

string <date-time>

实际抵达交货地时间

可选

dschTime

string <date-time>

卸船时间

可选

pickupreference

string

提货信息（Firms code等）

可选

<= 128 字符

railcode

string

铁路公司代码

可选

<= 12 字符

terminalPld

string

交货地码头

可选

<= 164 字符

terminalDtp

string

目的港码头

可选

<= 164 字符

ctnrInfos

array [object {13}]

箱子信息数组

可选

示例

{
    "code": 200,
    "type": "S",
    "message": null,
    "data": [
        {
            "batchId": "123456789",
            "requestId": "20250507164300",
            "referenceNo": "BMOU5314710",
            "localKey": "",
            "blNo": "",
            "bkgNo": "",
            "ctnrNo": "BMOU5314710",
            "carrierCd": "OOCL",
            "carrier": "东方海外货柜航运有限公司",
            "vesselName": "CMA CGM LA TRAVIATA",
            "voyage": "296E",
            "plrCd": "CNYTN",
            "plr": "Yantian,Shenzhen,Guangdong,China",
            "polCd": "CNYTN",
            "pol": "Yantian,Shenzhen,Guangdong,China",
            "podCd": "USORF",
            "pod": "Norfolk,Virginia,United States",
            "pldCd": "USORF",
            "pld": "Norfolk,Virginia,United States",
            "cyOpenTime": "",
            "cyCutOffTime": "",
            "dlptTime": "2025-04-03 19:15:00",
            "etd": "2025-04-03 19:15:00",
            "eta": "2025-05-10 09:30:00",
            "ata": "",
            "etaPLD": "2025-05-11 12:00:00",
            "ataPLD": "",
            "dschTime": "",
            "pickupreference": "",
            "railcode": "",
            "terminalPld": "",
            "terminalDtp": "",
            "ctnrInfos": [
                {
                    "ctnrNo": "BMOU5314710",
                    "sealNo": "",
                    "ctnrSize": "40",
                    "ctnrType": "HQ",
                    "pkgs": "",
                    "gwgt": "",
                    "vgm": "",
                    "currentStatusCd": "DLPT",
                    "currentStatus": "离港",
                    "currentStatusTime": "2025-04-03 19:15:00",
                    "currentPlaceCd": "CNYTN",
                    "currentPlace": "Yantian,Shenzhen,Guangdong,China",
                    "ctnrStatus": [
                        {
                            "statusCd": "STSP",
                            "statusDesc": "提空箱",
                            "statusDescEn": "Container Picked Up(Facility)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-03-25 23:49:00",
                            "place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "",
                            "statusDesc": "Arrived(Port of Load)",
                            "statusDescEn": "Arrived(Port of Load)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-03-26 17:56:00",
                            "place": "Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "GITM",
                            "statusDesc": "码头进场",
                            "statusDescEn": "Container Received by Carrier(Origin)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-03-26 17:56:00",
                            "place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "LOBD",
                            "statusDesc": "装船",
                            "statusDescEn": "Loaded(Port of Load)",
                            "vesselName": "CMA CGM LA TRAVIATA",
                            "voyage": "296E",
                            "eventTime": "2025-04-03 17:29:00",
                            "place": "Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "DLPT",
                            "statusDesc": "离港",
                            "statusDescEn": "DEPARTURE FROM LOAD PORT",
                            "vesselName": "CMA CGM LA TRAVIATA",
                            "voyage": "296E",
                            "eventTime": "2025-04-03 19:15:00",
                            "place": "Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "VESSLE",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "BDAR",
                            "statusDesc": "目的港抵港",
                            "statusDescEn": "BOARD ARRIVE",
                            "vesselName": "CMA CGM LA TRAVIATA",
                            "voyage": "296E",
                            "eventTime": "2025-05-10 09:30:00",
                            "place": "Norfolk,Virginia,United States",
                            "placeCd": "USORF",
                            "transportMode": "VESSLE",
                            "isEstimate": true,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": true
                        },
                        {
                            "statusCd": "PDAR",
                            "statusDesc": "抵达交货地",
                            "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-05-11 12:00:00",
                            "place": "Norfolk,Virginia,United States",
                            "placeCd": "USORF",
                            "transportMode": "",
                            "isEstimate": true,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": true
                        }
                    ]
                }
            ]
        }
    ]
}

示例代码

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 '{
    "code": 200,
    "type": "S",
    "message": null,
    "data": [
        {
            "batchId": "123456789",
            "requestId": "20250507164300",
            "referenceNo": "BMOU5314710",
            "localKey": "",
            "blNo": "",
            "bkgNo": "",
            "ctnrNo": "BMOU5314710",
            "carrierCd": "OOCL",
            "carrier": "东方海外货柜航运有限公司",
            "vesselName": "CMA CGM LA TRAVIATA",
            "voyage": "296E",
            "plrCd": "CNYTN",
            "plr": "Yantian,Shenzhen,Guangdong,China",
            "polCd": "CNYTN",
            "pol": "Yantian,Shenzhen,Guangdong,China",
            "podCd": "USORF",
            "pod": "Norfolk,Virginia,United States",
            "pldCd": "USORF",
            "pld": "Norfolk,Virginia,United States",
            "cyOpenTime": "",
            "cyCutOffTime": "",
            "dlptTime": "2025-04-03 19:15:00",
            "etd": "2025-04-03 19:15:00",
            "eta": "2025-05-10 09:30:00",
            "ata": "",
            "etaPLD": "2025-05-11 12:00:00",
            "ataPLD": "",
            "dschTime": "",
            "pickupreference": "",
            "railcode": "",
            "terminalPld": "",
            "terminalDtp": "",
            "ctnrInfos": [
                {
                    "ctnrNo": "BMOU5314710",
                    "sealNo": "",
                    "ctnrSize": "40",
                    "ctnrType": "HQ",
                    "pkgs": "",
                    "gwgt": "",
                    "vgm": "",
                    "currentStatusCd": "DLPT",
                    "currentStatus": "离港",
                    "currentStatusTime": "2025-04-03 19:15:00",
                    "currentPlaceCd": "CNYTN",
                    "currentPlace": "Yantian,Shenzhen,Guangdong,China",
                    "ctnrStatus": [
                        {
                            "statusCd": "STSP",
                            "statusDesc": "提空箱",
                            "statusDescEn": "Container Picked Up(Facility)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-03-25 23:49:00",
                            "place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "",
                            "statusDesc": "Arrived(Port of Load)",
                            "statusDescEn": "Arrived(Port of Load)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-03-26 17:56:00",
                            "place": "Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "GITM",
                            "statusDesc": "码头进场",
                            "statusDescEn": "Container Received by Carrier(Origin)",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-03-26 17:56:00",
                            "place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "TRUCK",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "LOBD",
                            "statusDesc": "装船",
                            "statusDescEn": "Loaded(Port of Load)",
                            "vesselName": "CMA CGM LA TRAVIATA",
                            "voyage": "296E",
                            "eventTime": "2025-04-03 17:29:00",
                            "place": "Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "VESSEL",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "DLPT",
                            "statusDesc": "离港",
                            "statusDescEn": "DEPARTURE FROM LOAD PORT",
                            "vesselName": "CMA CGM LA TRAVIATA",
                            "voyage": "296E",
                            "eventTime": "2025-04-03 19:15:00",
                            "place": "Yantian,Shenzhen,Guangdong,China",
                            "placeCd": "CNYTN",
                            "transportMode": "VESSLE",
                            "isEstimate": false,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": false
                        },
                        {
                            "statusCd": "BDAR",
                            "statusDesc": "目的港抵港",
                            "statusDescEn": "BOARD ARRIVE",
                            "vesselName": "CMA CGM LA TRAVIATA",
                            "voyage": "296E",
                            "eventTime": "2025-05-10 09:30:00",
                            "place": "Norfolk,Virginia,United States",
                            "placeCd": "USORF",
                            "transportMode": "VESSLE",
                            "isEstimate": true,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": true
                        },
                        {
                            "statusCd": "PDAR",
                            "statusDesc": "抵达交货地",
                            "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                            "vesselName": "",
                            "voyage": "",
                            "eventTime": "2025-05-11 12:00:00",
                            "place": "Norfolk,Virginia,United States",
                            "placeCd": "USORF",
                            "transportMode": "",
                            "isEstimate": true,
                            "dateUpdateTime": "2025-04-28 13:44:03",
                            "sourceCd": "1",
                            "estimate": true
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢200sucess

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