服务介绍

使用港口五位码和时间周期查询在未来某一时间段预计到达该港口的船舶列表和船舶信息。

适用场景

1、海上监管。根据港口在未来某一时间段即将到港的船舶，筛选不同的船舶类型和船籍国，可以提前分配海关或边检资源，并且结合船舶历史异常AIS事件或搭靠等信息，分析风险船舶。

2、物流找船。在发货仓附近的港口筛选即将到达的货运船舶列表，再通过船舶档案的经营公司信息或企业运力池维护的船舶通讯录，开始发货邀约等。

3、航运分析。分析港口承载情况以及港口所有预抵船舶的属性信息。

请求限制

此服务为高级服务，需要申请高级权限才可使用，使用前需要在控制台创建您应用的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/GetETAShips	Get

请求调用示例

https://api.shipxy.com/apicall/v3/GetETAShips?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG&start_time=1746612218&end_time=1747044218&ship_type=0

**注：**例子中的 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": 1410,
    "data": [
        {
            "mmsi": 210563000,
            "ship_name": "SPECTRUM OF THE SEAS",
            "imo": 9778856,
            "dwt": 0,
            "ship_type": "客船",
            "length": 348,
            "width": 42,
            "draught": 8.9,
            "preport_cnname": "八代",
            "last_time": "2025-05-09 13:42:55",
            "last_time_utc": 1746769375,
            "eta": "2025-05-10 05:38:46",
            "eta_utc": 1746826726,
            "dest": "上海",
            "ship_flag": "塞浦路斯"
        }
    ]
}

2.4 港口预抵船舶查询

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

2.4 港口预抵船舶查询

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例