服务介绍

使用港口五位码查询当前港口正在靠泊的全部船舶信息，包括当前靠泊船的总数量、船舶类型、船舶基础信息、船舶到达港口时间和停留时间。

适用场景

可以通过返回数据中不同类型船舶停留的时长，分析作业时长的平均规律。在物流场景中也可以根据当前在港的靠泊船信息，筛选出船舶类型，配合您找船运货。在船舶加油、船舶设备更新等场景获取在港船舶的列表，再使用船舶档案查询了解船舶设备等信息，配合您找出适合做船舶加油或设备更新推荐等。

港口靠泊船列表清单中，存在一些长期维修或者转售变更mmsi号的船舶，因为没有离港时间所以一直在停靠列表中存在，针对不同的行业场景可以进行屏蔽筛选。如果是监管类场景可以选择保留全部数据进行分析，如果是物流类客户计算港口流动情况，可以通过参数屏蔽掉此类结果，之后再自行计算。

请求限制

此服务为高级服务，需要申请高级权限才可使用，使用前需要在控制台创建您应用的key。请求服务时，会根据您所属权限的类型限制访问的数量，您当前使用服务的权限清单在控制台中可以查看。开通服务权限请联系商务：https://api.shipxy.com/v3/console/support

在线调试

提供无开发经验的用户在线访问接口数据，了解服务获取样例。需要提前创建船讯网API key并具备权限，对应的API Key需要到https://api.shipxy.com/v3/console/overview 获取，参见https://33iwh234s7.apifox.cn/8961339m0

请求地址

请求地址	请求方式
https://api.shipxy.com/apicall/v3/GetBerthShips	Get

请求调用示例

https://api.shipxy.com/apicall/v3/GetBerthShips?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

⚪0成功

application/json

成功返回靠泊船信息

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "total": 713,
    "data": [
        {
            "mmsi": 100900006,
            "imo": 0,
            "call_sign": "YYYY",
            "ship_name": "AISTESTSHIP",
            "ship_type": 70,
            "length": 50,
            "width": 6,
            "left": 5,
            "trail": 10,
            "draught": 0,
            "arrival_time": "2025-05-06 06:35:54",
            "arrival_time_utc": "1746484554",
            "stay_time": 2166.2
        }
    ]
}

2.2 港口当前靠泊船查询

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

2.2 港口当前靠泊船查询

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例