云当网数据接口
  1. 海运跟踪
云当网数据接口
  • 通用接口
    • API Token获取
      • 获取Token
  • 海运数据接口
    • 海运跟踪
      • 海运状态码
      • 海运支持清单
      • 海运跟踪单号订阅
        POST
      • 海运箱动态全量推送(按提单号/订舱号订阅)
        POST
      • 海运跟踪下载(按提单号/订舱号订阅)
        POST
      • 海运跟踪箱号订阅
        POST
      • 海运箱动态全量推送(按箱号订阅)
        POST
      • 海运跟踪下载(按箱号订阅)
        POST
      • 海运箱动态推送(单节点)
        POST
      • 集装箱海上轨迹
        GET
      • 港区数据订阅
        POST
      • 港区数据全量推送
        POST
      • 港区数据订阅下载
        POST
    • 船舶靠泊计划
      • 船舶靠泊计划
    • 船期表
      • 船期表获取
    • 船舶AIS
      • 单船搜索
      • 船舶定位
      • 船舶历史挂港
      • 船舶轨迹
  • 陆运数据接口
    • EIR(电子设备交接单)
      • Eir获取API
    • 场站数据
      • 场站数据查询订阅接口
      • 场站数据推送
    • 车辆GPS
      • 车辆定位
      • 车辆轨迹
  • 关务数据接口
    • 报关状态
      • 报关状态查询
      • 报关状态推送
    • 舱单数据
      • 上传订阅海运舱单
      • 海运舱单订阅数据下载
  • 美国目的港数据接口
    • 美国码头数据
      • 美国码头支持清单
      • 美国码头信息订阅
      • 美国码头数据下载
    • 美国清关状态
      • 清关状态代码
      • 美国清关数据查询接口
  • OCR识别
    • 报关单识别接口
    • 发票/清关识别接口
  • 空运数据接口
    • 空运支持清单
    • 空运状态代码
    • 空运跟踪订阅
    • 空运状态节点全量推送
    • 空运状态单节点推送
    • 空运跟踪下载
  • 快递数据接口
    • 国家、地区ISO Alpha-3代码表
    • 主状态代码表
    • 子状态代码表
    • 承运商代码表
    • 承运商集团表
    • 特殊承运人代码表
    • 快递跟踪订阅
    • 快递跟踪下载
    • 快递跟踪全量推送
  1. 海运跟踪

集装箱海上轨迹

GET
http://apis.my56home.com/api/v1/vesselstatus
调用该接口前,需要先使用[获取Token API]获取token。token 有效期是2小时,超过了2小时得重新获取。

请求参数

Query 参数
companyid
string 
企业编号
必需
示例值:
1000
referenceno
string 
必需
订阅号(提单号订阅时,传提单号;订舱号订阅时,传订舱号;箱号订阅时传箱号)
token
string 
可选
Token(先调用“获取token”的API,获取token)
示例值:
d450e2c1-0699-4521-a73a-4f053b04f0ba
Body 参数application/x-www-form-urlencoded
object {0}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://apis.my56home.com/api/v1/vesselstatus?companyid=1000&referenceno=&token=d450e2c1-0699-4521-a73a-4f053b04f0ba'

返回响应

🟢200成功
application/json
Body
objVesselStatus
object 
可选
vslname
string 
船名(Vessel Name)
可选
>= 64 字符<= 64 字符
longitude
number <double>
最新经度(Latest Longitude)
可选
>= 16<= 16
latitude
number <double>
最新纬度(Latest Latitude)
可选
>= 16<= 16
mmsi
string 
MMSI号(MMSI number)
可选
>= 18 字符<= 18 字符
imono
string 
IMO号(IMO number)
可选
eta
string <date-time>
预计抵达下一港口的时间(Expected arrival time at the next port)
可选
dtp
string 
下一港名称(Next Port Name)
可选
>= 64 字符<= 64 字符
dtpcd
string 
下一港代码(Next Port Code)
可选
>= 5 字符<= 5 字符
lsttrajectory
array [object {5}] 
可选
status
integer 
状态码(Status code)
可选
0=成功;2=失败;1000=查无数据;(0=successful; 2=failed; 1000=no data found;)
message
string 
错误信息(error message)
可选
>= 256 字符<= 256 字符
示例
{
    "objVesselStatus": {
        "vslname": "HMM DUBLIN",
        "longitude": 98.78697,
        "latitude": 4.954335,
        "mmsi": "356429000",
        "imono": "9863314",
        "eta": "2022-04-01",
        "dtp": "XIAMEN",
        "dtpcd": "CNXMN",
        "lsttrajectory": [
            {
                "head": null,
                "trail": "309",
                "longitude": 99.000918,
                "latitude": 4.766195,
                "statustime": "2020-10-10T02:35:43"
            },
            {
                "head": null,
                "trail": "317",
                "longitude": 98.78697,
                "latitude": 4.954335,
                "statustime": "2020-10-10T03:30:25"
            }
        ]
    },
    "success": null,
    "status": 0,
    "message": null,
    "data": null,
    "faildata": null
}
上一页
海运箱动态推送(单节点)
下一页
港区数据订阅
Built with