Trackingeyes数据接口
  1. 海运跟踪
Trackingeyes数据接口
  • 通用接口
    • 获取token
      POST
    • 获取云当港口支持代码
      GET
  • 海运数据接口
    • 海运跟踪
      • 海运状态码
      • 海运支持清单
      • 批量运单订阅接口
        POST
      • 推送运单动态接口
        POST
      • 下载运单详情接口
        GET
    • 港区数据
      • 港区支持清单
      • 港区数据订阅接口
      • 港区数据推送接口
      • 港区数据下载接口
    • 集装箱轨迹
      • 集装箱轨迹接口
    • 船舶AIS
      • 单船搜索接口
      • 船舶定位接口
      • 船舶历史挂港接口
      • 船舶轨迹接口
    • 船舶计划
      • 口岸支持清单
      • 船舶计划查询接口
    • 船东电商运价
      • 运价支持清单
      • 运价查询接口
  • 船期表接口
    • 港到港船期
      • 船期支持清单
      • 港到港船期查询接口
      • 船期分页推送接口
    • 航线规划路径
      • 航线规划路径接口
    • 航次挂靠路径
      • 航次挂靠路径支持清单
      • 航次挂靠路径查询接口
  • 空运数据接口
    • 空运状态码
    • 空运支持清单
    • 空运跟踪
      • 批量运单订阅接口
      • 推送运单动态接口
      • 批量运单下载接口
  • 陆运数据接口
    • EIR(电子设备交接单)
      • EIR支持清单
      • EIR获取接口
    • 场站数据
      • 场站支持清单
      • 场站数据订阅接口
      • 场站数据推送接口
    • 车辆GPS
      • 车辆定位接口
      • 车辆轨迹接口
  • 关务数据接口
    • 报关状态
      • 报关状态代码表
      • 报关状态订阅接口
      • 报关状态推送接口
      • 下载报关状态接口
    • 舱单数据
      • 舱单数据订阅接口
      • 舱单数据推送接口
  • 快递数据接口
    • 国家、地区ISO Alpha-3代码表
    • 主状态代码表
    • 子状态代码表
    • 承运商代码表
    • 承运商集团表
    • 特殊承运人代码表
    • 快递数据订阅接口
    • 快递数据推送接口
    • 快递数据下载接口
  • 其他接口
    • 通用港杂费
      • 港杂费代码清单
      • 通用港杂费查询接口
    • 操作时间
      • 操作时间查询接口
  1. 海运跟踪

下载运单详情接口

GET
/api/oceanbill/oceanBill
1.接口仅获取单个运单详情。
2.调用次数限制:一分钟60次。
3.所有的时间字段都是字符串类型,格式为 "yyyy-MM-dd HH:mm:ss", 如果时间没有值则为空字符串""。

请求参数

Query 参数
companyCode
string 
必需
企业编号(需向云当网申请)
token
string 
必需
获取token接口返回的记录
orgCode
string 
组织代码
可选
billId
string 
必需
运单关键字,运单订阅接口返回的id

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.trackingeyes.com/api/oceanbill/oceanBill?companyCode&token&orgCode&billId'

返回响应

🟢200成功
application/json
Body
code
integer 
状态代码
必需
200=成功,其他=失败
codeDesc
string 
状态描述
必需
<= 8 字符
message
string 
异常信息
必需
<= 255 字符
result
object 
结果
必需
id
string 
运单关键字
必需
运单订阅接口返回的id
<= 32 字符
referenceNo
string 
订阅单号
可选
<= 32 字符
deliveryNo
string 
交货单号
可选
<= 38 字符
orderNo
string 
需货单号
可选
<= 600 字符
localKey
string 
客户本地关键字
可选
<= 38 字符
blNo
string 
提单号
可选
<= 128 字符
bkgNo
string 
订舱号
可选
<= 128 字符
ctnrNo
string 
箱号
可选
<= 11 字符
carrierCd
string 
云当船东代码
可选
<= 18 字符
carrier
string 
船东简称
可选
<= 164 字符
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>
实际到港时间
可选
firstETA
string <date-time>
开航后第一次获取到的预计抵港时间
可选
etaPld
string <date-time>
预计抵达交货地时间
可选
ataPld
string <date-time>
实际抵达交货地时间
可选
dschTime
string <date-time>
卸船时间
可选
endTrackTime
string <date-time>
结束跟踪时间
可选
firstUpdateTime
string <date-time>
首次获取到数据时间
可选
dataUpdateTime
string <date-time>
数据更新时间
可选
endStatus
string 
结束状态
可选
空值‘’=未结束,E=正常结束,EF=强制结束
<= 20 字符
trackStatus
string 
跟踪状态中文描述
可选
<= 20 字符
trackStatusCd
string 
跟踪状态
可选
T=跟踪中、E=跟踪结束、F=跟踪失败
<= 20 字符
errorStatus
string 
异常状态
可选
T=提示、E=错误,空值
<= 20 字符
errorMessage
string 
异常备注
可选
<= 255 字符
dataStatus
string 
数据状态
可选
Y=有数据,B=船东无数据,空值
<= 20 字符
billCreateTime
string <date-time>
运单订阅时间
可选
status
string 
订阅状态
可选
B=订阅中,S=订阅成功,F=订阅失败
<= 10 字符
errorDes
string 
订阅失败信息
可选
<= 255 字符
ctnrInfos
array [object {14}] 
箱信息
必需
carriges
array [object {14}] 
航程
可选
示例
{
    "code": 200,
    "codeDesc": "success",
    "message": "Operation succeeded",
    "result": {
        "id": "1915229213674311680",
        "referenceNo": "025F605301",
        "deliveryNo": "",
        "orderNo": "",
        "localKey": "",
        "blNo": "025F605301",
        "bkgNo": "",
        "ctnrNo": "WHSU5390850",
        "carrierCd": "WHL",
        "carrier": "万海航运有限公司",
        "vesselName": "WAN HAI 328",
        "voyage": "S050",
        "plrCd": "CNSHK",
        "plr": "SHEKOU (CN)",
        "polCd": "CNSHK",
        "pol": "SHEKOU (CN)",
        "podCd": "MYLPK",
        "pod": "PORT KLANG NORTH PORT (MY)",
        "pldCd": "MYLPK",
        "pld": "PORT KLANG NORTH PORT (MY)",
        "cyOpenTime": "",
        "cyCutOffTime": "",
        "dlptTime": "2025-04-28 00:48:01",
        "etd": "2025-04-28 00:00:00",
        "eta": "2025-05-02 00:00:00",
        "ata": "2025-05-02 20:37:59",
        "firstETA": "2025-05-01 00:00:00",
        "etaPld": "2025-05-02 00:00:00",
        "ataPld": "2025-05-02 20:37:59",
        "dschTime": "2025-05-02 20:37:59",
        "endTrackTime": "2025-05-06 14:24:46",
        "firstUpdateTime": "2025-04-24 10:23:22",
        "dataUpdateTime": "2025-05-07 14:50:13",
        "endStatus": "E",
        "trackStatus": "跟踪结束",
        "trackStatusCd": "E",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "billCreateTime": "2025-04-24 10:20:05",
        "status": "S",
        "errorDes": "",
        "ctnrInfos": [
            {
                "ctnrNo": "WHSU5390850",
                "sealNo": "",
                "ctnrSize": "40",
                "ctnrType": "HQ",
                "pkgs": "",
                "gwgt": "",
                "vgm": "",
                "currentStatusCd": "RCVE",
                "currentStatus": "还空箱",
                "currentStatusTime": "2025-05-06 10:34:00",
                "currentPlaceCd": "MYLPK",
                "currentPlace": "Yi Chun Odd",
                "isRolled": "",
                "ctnrStatus": [
                    {
                        "statusCd": "RCVE",
                        "statusDesc": "还空箱",
                        "statusDescEn": "Empty Container Discharged From Vessel Or Gate In To Pier/Terminal/Off-Dock Depot (Empty Available)",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2025-05-06 10:34:00",
                        "place": "Yi Chun Odd",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "STCS",
                        "statusDesc": "提重柜/提货",
                        "statusDescEn": "Full Container Withdrawn By Consignee From Pier/Terminal",
                        "vesselName": "WAN HAI 328",
                        "voyage": "N050",
                        "eventTime": "2025-05-04 12:27:00",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "DSCH",
                        "statusDesc": "目的港卸船",
                        "statusDescEn": "Full Container(Fcl) Discharged From Vessel Or Gate In To Pier/Terminal",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:38:00",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "PDDS",
                        "statusDesc": "交货地卸箱",
                        "statusDescEn": "Full Container(Fcl) Discharged From Vessel Or Gate In To Pier/Terminal",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:38:00",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "PDAR",
                        "statusDesc": "抵达交货地",
                        "statusDescEn": "PLACE OF DELIVERY ARRIVAL",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:37:59",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "VESSLE",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "BDAR",
                        "statusDesc": "目的港抵港",
                        "statusDescEn": "BOARD ARRIVE",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-05-02 20:37:59",
                        "place": "Port Klang North Port - Ct1",
                        "placeCd": "MYLPK",
                        "transportMode": "VESSLE",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "DLPT",
                        "statusDesc": "离港",
                        "statusDescEn": "DEPARTURE FROM LOAD PORT",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-04-28 00:48:01",
                        "place": "SHEKOU (CN)",
                        "placeCd": "CNSHK",
                        "transportMode": "VESSLE",
                        "sourceCd": "4",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "LOBD",
                        "statusDesc": "装船",
                        "statusDescEn": "Laden Ctnr Loaded On Board Vessel.(Mother Vessel,Fixed Slot Charter/Joint Venture Vessel)",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-04-28 00:48:00",
                        "place": "Sku01",
                        "placeCd": "CNSHK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "GITM",
                        "statusDesc": "码头进场",
                        "statusDescEn": "Outbound Full Container Gate In To Peir/Terminal(Fcl)",
                        "vesselName": "WAN HAI 328",
                        "voyage": "S050",
                        "eventTime": "2025-04-23 20:43:00",
                        "place": "Sku01",
                        "placeCd": "CNSHK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    },
                    {
                        "statusCd": "STSP",
                        "statusDesc": "提空箱",
                        "statusDescEn": "Empty Container Released To Shipper From Pier/Terminal/Off-Dock Depot",
                        "vesselName": "",
                        "voyage": "",
                        "eventTime": "2025-04-22 23:14:00",
                        "place": "Sku01",
                        "placeCd": "CNSHK",
                        "transportMode": "",
                        "sourceCd": "1",
                        "isEstimate": false
                    }
                ]
            }
        ],
        "carriges": [
            {
                "sno": 1,
                "polCd": "CNSHK",
                "polNameEn": "SHEKOU (CN)",
                "polNameCn": "蛇口",
                "podCd": "MYLPK",
                "podNameEn": "Port Klang North Port - Ct1",
                "podNameCn": "巴生北港",
                "etd": "2025-04-28 00:00:00",
                "atd": "2025-04-28 00:48:01",
                "eta": "2025-05-02 00:00:00",
                "ata": "2025-05-02 20:37:59",
                "vesselName": "WAN HAI 328",
                "voy": "S050",
                "type": ""
            }
        ]
    }
}
上一页
推送运单动态接口
下一页
港区支持清单
Built with