服务介绍

使用港口五位码查询港口在某一时间周期内历史靠泊的所有船舶信息。包括船舶基础信息、船舶在该港口的靠港记录以及船舶在上一个港口和下一个港口的靠港记录信息。

适用场景

1、物流跟踪。查询分析港口在某一时间段内挂靠船舶的数量，所在泊位的分布以及靠泊的时间。根据不同船舶分类筛选统计船舶在港口的平均等待时长和作业时长，预估船舶在港口的排队时间。
2、港口分析。

请求限制

此服务使用前需要在控制台创建您应用的key。请求服务时，会根据您所属权限的类型限制访问的数量，您当前使用服务的权限清单在控制台中可以查看。默认查询一个月以内的历史记录，如果需要开通半年、一年或者更多时间的挂靠记录查询，请联系商务开通。

在线调试

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

请求地址

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

请求调用示例

https://api.shipxy.com/apicall/v3/GetPortofCallByPort?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG&start_time=1744467589&end_time=1744967589

**注：**例子中的 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": 5140,
    "data": [
        {
            "imo": 0,
            "mmsi": 413842124,
            "ship_type": "货船",
            "ship_name": "ZHEJIAXINGHUO03191",
            "call_sign": "0",
            "currentport": {
                "port_code": "27999",
                "port_cnname": "上海",
                "port_name": "Shanghai",
                "port_time_zone": "+8",
                "terminal_name": "",
                "berth_name": "",
                "arrival_anchorage": "",
                "ata": "2025-04-12 22:33:13",
                "atb": "2025-04-12 22:33:13",
                "atd": "2025-04-14 21:04:06",
                "arrival_draught": 0,
                "departure_draught": 0,
                "stay_time": 46.51,
                "stay_terminal_time": 46.51
            },
            "previousport": {
                "port_code": "27999",
                "port_cnname": "上海",
                "port_name": "Shanghai",
                "port_time_zone": "+8",
                "arrival_anchorage": "",
                "ata": "2025-04-08 19:00:14",
                "atb": "2025-04-08 19:00:14",
                "atd": "2025-04-08 22:00:57"
            },
            "nextport": {
                "port_code": "213479",
                "port_cnname": "奉贤",
                "port_name": "Fengxian",
                "port_time_zone": "+8",
                "arrival_anchorage": "",
                "ata": "2025-04-13 02:54:45",
                "atb": "2025-04-13 02:54:45",
                "atd": "2025-04-13 06:53:31"
            }
        },
        {
            "imo": 9302530,
            "mmsi": 412046070,
            "ship_type": "拖轮",
            "ship_name": "HU JIU 18",
            "call_sign": "BSAR",
            "currentport": {
                "port_code": "27999",
                "port_cnname": "上海",
                "port_name": "Shanghai",
                "port_time_zone": "+8",
                "terminal_name": "Eastern Tankstore Shanghai",
                "berth_name": "No 2",
                "arrival_anchorage": "",
                "ata": "2025-04-12 22:48:25",
                "atb": "2025-04-12 22:48:25",
                "atd": "2025-04-24 18:06:44",
                "arrival_draught": 3500,
                "departure_draught": 3500,
                "stay_time": 283.31,
                "stay_terminal_time": 283.31
            },
            "previousport": {
                "port_code": "213784",
                "port_cnname": "崇明",
                "port_name": "Chongming",
                "port_time_zone": "+8",
                "arrival_anchorage": "",
                "ata": "2025-04-12 15:53:58",
                "atb": "2025-04-12 15:53:58",
                "atd": "2025-04-12 21:44:06"
            },
            "nextport": {
                "port_code": "213784",
                "port_cnname": "崇明",
                "port_name": "Chongming",
                "port_time_zone": "+8",
                "arrival_anchorage": "",
                "ata": "2025-04-16 12:17:08",
                "atb": "2025-04-16 12:17:08",
                "atd": "2025-04-16 16:19:14"
            }
        },
    ......
    ]
}

4.4 港口挂靠历史船舶

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

4.4 港口挂靠历史船舶

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例