1. 1 船舶查询
Shipxy
  • 船讯网API服务概述
  • 文档目录
  • 注册与创建应用
  • 多语言SDK引入
  • 标准API服务
    • 1 船舶查询
      • 1.1 船舶位置查询
        • 1.1.1 单船位置查询
        • 1.1.2 多船位置查询
        • 1.1.3 船队位置查询
      • 1.2 船舶模糊查询
        GET
      • 1.3 周边船舶查询
        GET
      • 1.4 区域船舶查询
        GET
      • 1.5 船舶船籍查询
        GET
      • 1.6 船舶档案查询
        GET
      • 1.7 档案服务扩展
        GET
    • 2 港口查询
      • 2.1 港口信息查询
      • 2.2 港口当前靠泊船查询
      • 2.3 港口当前到锚船查询
      • 2.4 港口预抵船舶查询
    • 3 历史行为
      • 3.1 船舶历史轨迹查询
      • 3.2 船舶互相搭靠记录查询
    • 4 挂靠记录
      • 4.1 船舶历史挂靠记录
      • 4.2 船舶挂靠指定港口记录
      • 4.3 船舶当前挂靠信息
      • 4.4 港口挂靠历史船舶
    • 5 航线规划
      • 5.1 点到点航线规划
      • 5.2 港到港航线规划
      • 5.3 预计到达时间(ETA)查询
    • 6 天气气象
      • 6.1 新全球气象
        • 6.1.1 实时气象数据
        • 6.1.2 未来气象预报
      • 6.2 全球台风
        • 6.2.1 获取全球台风列表
        • 6.2.2 获取单个台风信息
      • 6.3 国内港口潮汐
        • 6.3.1 查询国内潮汐观测站列表
        • 6.3.2 查询单个观测站潮汐详情
      • 6.4 全球港口潮汐
        • 6.4.1 查询全球潮汐观测站列表
        • 6.4.2 查询单个观测站潮汐详情
      • 6.5 海区气象
      • 6.6 单点海洋气象
      • 6.7 历史气象记录
    • 7 海图GIS平台开发
      • 7.1 快速入门：从注册到接入
      • 7.2 地图引擎基础：地图控制与业务绘制
      • 7.3 船位展示服务
      • 7.4 历史轨迹服务
      • 7.5 图层与气象服务
      • 7.6 航线绘制与区域回放服务
      • 7.7 Vue项目接入指南
      • 7.8 API Key后端代理接入
      • 7.9 坐标系转换指南
      • 7.10 私有化部署开发指南
        • 01 私有化地图加载绘制
        • 02 船舶与轨迹绘制实践
        • 03 气象图层效果绘制
    • 8 海事数据
      • 8.1 航行警告查询
    • 9 监控推送
      • 9.1 监控船队管理
        • 9.1.1 创建船队
        • 9.1.2 更新船队信息
        • 9.1.3 查询船队
        • 9.1.4 删除船队
        • 9.1.5 船队船舶增加
        • 9.1.6 船队船舶批量更新
        • 9.1.7 船队船舶删除
      • 9.2 区域监控推送
        • 9.2.1 区域创建
        • 9.2.2 区域更新
        • 9.2.3 区域查询
        • 9.2.4 区域删除
        • 9.2.5 区域监控推送内容
      • 9.3 船舶航速提醒推送
        • 9.3.1 新增船舶订阅
        • 9.3.2 删除订阅船舶信息
        • 9.3.3 查询订阅船舶列表
        • 9.3.4 船舶航速异常推送
      • 9.4 实时船位推送
      • 9.5 船舶到离港事件推送
      • 9.6 船舶动态ETA推送
      • 9.7 船舶AIS信号消失事件推送
      • 9.8 船舶搭靠事件推送
    • 文档附录
      • 船舶类型对照表
      • 服务码返回说明
      • 海区对照表
      • 航行状态对照表
      • 绕航节点清单
      • 航标类型对照表
      • 区域船二进制解析说明
      • 常见问题
  • AI智能体应用
    • AI大模型接入MCP服务
    • 智能体场景应用
      • 运力资源智能体
      • 船舶风控智能体
      • 运输规划智能体
      • 航次时效预测智能体
      • 船舶安全监控智能体
      • 多式联运协同智能体
      • 大宗贸易态势分析智能体
  • 视频监控AI识别预警服务
    • 视频监控服务接入指南
    • 视频监控API服务说明
    • 视频监控场景应用指南
    • 视频监控服务FAQ与最佳实践
  • 场景化开发示例
    • 大宗物流运输智能决策平台
      • 1、港口运力监控与找船
      • 2、船队货运跟踪与 ETA
      • 3、货运异常预警中心
      • 4、大宗航运态势分析与经营决策大屏
      • 5、航次时效预测与滞期费测算
      • 6、航次能效与碳强度管理
    • 海上设施安全监管与决策平台
      • 1、监管区域与事件推送（总览大屏）
      • 2、设施周边安全监控
      • 3、偏航识别与轨迹回放
      • 4、气象海况与航行警告
      • 5、海上安全态势监管大屏与执法效能分析
      • 6、水域通航密度与碰撞风险预测
      • 7、设施运维作业窗口智能排程与船舶调度
  1. 1 船舶查询

1.7 档案服务扩展

GET

一、服务概述#

档案服务扩展是船讯网在现有档案底层数据基础上开放的一系列标准服务 API，为外部用户提供船舶安全检查记录、商业变更历史、历史事故记录和安全管理证书信息等档案数据查询能力。

1.1 基础信息#

项目说明
基础 URLhttps://api.shipxy.com/apicall/v3/
请求方式GET
授权码参数key，由船讯网提供的 API Key
返回格式JSON
字符编码UTF-8

1.2 权限说明#

外部服务使用 V3 版本的 API Key 调用。
外部服务权限按照船舶数量控制，分为开通、关闭、按船舶数量三种模式。
需在后台开通对应的权限内容后方可使用。

1.3 通用返回结构#

所有接口返回 JSON 格式数据，包含以下通用字段：
字段类型说明
statusint状态码，0 表示成功
msgstring状态信息，成功时为 "Success"
dataarray数据数组，包含具体的档案记录

二、接口详情#

2.1 船舶安全检查记录（PSC）#

接口说明：查询指定船舶在指定时间范围内的港口国监督检查（PSC）记录，包括检验时间、地点、船籍、船级社、缺陷数量和缺陷详情等信息。
项目说明
请求地址https://api.shipxy.com/apicall/v3/GetShipPSC
请求方式GET

请求参数#

参数名类型是否必填说明
keystring是船讯网提供的 API Key（授权码）
imouint32是船舶 IMO 编号
start_timestring是查询开始日期，格式 yyyy-MM-dd，如 2020-03-03
end_timestring是查询结束日期，格式 yyyy-MM-dd，如 2024-03-01

请求示例#

https://api.shipxy.com/apicall/v3/GetShipPSC?key=您的APIKEY&imo=9811000&start_time=2020-03-03&end_time=2024-03-01

返回参数#

属性标识名称类型说明
data数据数组arrayPSC 检查记录列表
└ inspection_time检验时间string格式如 2025-03-01
└ inspection_location检验地点string如 Ningbo
└ ship_name船舶名称string船舶名称
└ authorizer授权方string如 Tokyo MOU
└ registry船籍string如 Panama
└ class_name船级社string如 Lloyd's Register
└ ship_owner船舶所属公司string如 Jiayi Shipping Co Ltd-MAI
└ defect_number缺陷数量int如 3
└ defect_detail缺陷记录详情string如 Life saving appliances -Lifeboats

返回参数示例#

{
  "status": 0,
  "msg": "Success",
  "data": [
    {
      "inspection_time": "2025-03-01",
      "inspection_location": "Ningbo",
      "ship_name": "示例船名",
      "authorizer": "Tokyo MOU",
      "registry": "Panama",
      "class_name": "Lloyd's Register",
      "ship_owner": "Jiayi Shipping Co Ltd-MAI",
      "defect_number": 3,
      "defect_detail": "Life saving appliances -Lifeboats"
    }
  ]
}

注意事项#

查询时间范围通过 start_time 和 end_time 限定，日期格式为 yyyy-MM-dd。
缺陷数量为 0 表示该次检查未发现缺陷。
授权方（authorizer）通常为区域性备忘录组织，如 Tokyo MOU、Paris MOU 等。

2.2 船舶商业变更历史#

接口说明：查询指定船舶的商业信息变更历史记录，包括船籍国、集团所有方、船舶管理者、经营者、注册所有方、DOC 公司等信息的历史变更情况。
项目说明
请求地址https://api.shipxy.com/apicall/v3/GetShipBusinessHistory
请求方式GET

请求参数#

参数名类型是否必填说明
keystring是船讯网提供的 API Key（授权码）
imouint32是船舶 IMO 编号

请求示例#

https://api.shipxy.com/apicall/v3/GetShipBusinessHistory?key=您的APIKEY&imo=9811000

返回参数#

属性标识名称类型说明
data数据数组array商业变更历史记录列表。字段中数值为空代表此次变更中，该信息无变化
└ date时间string格式如 202503，表示产生商业变更记录的月份
└ ship_name船舶名称string船舶名称
└ flag_country船籍国string如 Panama
└ group_code集团所有方代码int如 1803477
└ group_company集团所有方名称string如 COSCO Shipping Development
└ group_country集团所有方所属国家string如 China, People's Republic of
└ ship_manager_code船舶管理者代码int如 1803477
└ ship_manager_company船舶管理者名称string如 COSCO Shipping Development
└ ship_manager_country船舶管理者所属国家string如 China, People's Republic of
└ operator_code船舶经营者代码int如 1803477
└ operator_company船舶经营者名称string如 COSCO Shipping Development
└ operator_country船舶经营者所属国家string如 China, People's Republic of
└ registered_code注册所有方代码int如 1803477
└ registered_owner注册所有方名称string如 COSCO Shipping Development
└ register_country注册所有方所属国家string如 China, People's Republic of
└ doc_codeDOC 公司代码int如 1803477
└ doc_companyDOC 公司名称string如 COSCO Shipping Development
└ doc_countryDOC 公司所属国家string如 China, People's Republic of

返回参数示例#

{
  "status": 0,
  "msg": "Success",
  "data": [
    {
      "date": "202503",
      "ship_name": "示例船名",
      "flag_country": "Panama",
      "group_code": 1803477,
      "group_company": "COSCO Shipping Development",
      "group_country": "China, People's Republic of",
      "ship_manager_code": 1803477,
      "ship_manager_company": "COSCO Shipping Development",
      "ship_manager_country": "China, People's Republic of",
      "operator_code": 1803477,
      "operator_company": "COSCO Shipping Development",
      "operator_country": "China, People's Republic of",
      "registered_code": 1803477,
      "registered_owner": "COSCO Shipping Development",
      "register_country": "China, People's Republic of",
      "doc_code": 1803477,
      "doc_company": "COSCO Shipping Development",
      "doc_country": "China, People's Republic of"
    }
  ]
}

注意事项#

字段中数值为空代表此次变更中，该信息无变化。只有发生变更的字段才会有数值。
date 字段格式为 yyyyMM（年月），如 202503 表示 2025 年 3 月。
每条记录代表一次商业信息变更事件，通过对比不同记录中各字段的变化可追溯船舶所有权和管理权的变更历程。
集团所有方、船舶管理者、经营者、注册所有方和 DOC 公司可能为同一实体，也可能不同。

2.3 船舶历史事故记录#

接口说明：查询指定船舶在指定时间范围内的历史事故记录，包括事故编号、日期、地点、类型、严重程度和详细描述等信息。
项目说明
请求地址https://api.shipxy.com/apicall/v3/GetShipAccidents
请求方式GET

请求参数#

参数名类型是否必填说明
keystring是船讯网提供的 API Key（授权码）
imouint32是船舶 IMO 编号
start_timestring是查询开始日期，格式 yyyy-MM-dd，如 2020-03-03
end_timestring是查询结束日期，格式 yyyy-MM-dd，如 2024-03-01

请求示例#

https://api.shipxy.com/apicall/v3/GetShipAccidents?key=您的APIKEY&imo=9811000&start_time=2020-03-03&end_time=2024-03-01

返回参数#

属性标识名称类型说明
data数据数组array历史事故记录列表
└ sequence事故序号int按 1, 2, 3, 4 依次排列，表示船舶自身的事件序号
└ casualty_id事故编号string如 91021980046795，事故唯一编号
└ ship_name事故发生时的船名string事故发生时的船舶名称
└ accident_data事故日期string格式如 2025-09-17
└ accident_loaction事故发生的地点区域string如 Br.lsles, N.Sea, E.Chnl, Biscay
└ accident_type事故类型string见下方事故类型对照表
└ severity_indicator事故严重级别程度stringSerious 或 Not Serious
└ text事故详细描述string详细的文本描述

事故类型对照表#

中文英文（标准术语）说明
碰撞Collision船舶与另一艘船或物体相撞
接触Contact船舶与固定物（如码头、浅滩）发生接触但未严重损坏
倾覆Foundered通常指"沉没"或"倾覆"，但需注意：Foundered 不是搁浅
火灾/爆炸Fire/Explosion明确区分火灾和爆炸
船体/机械损坏Hull/Mch.Damage"Mch."是"Mechanical"的缩写，表示机械故障或结构损坏
战争损失/敌对行为War Loss/Hostilities因战争、海盗、武装冲突等造成的损失
失踪Missing船只失联，无法确认位置
搁浅/困住Wrecked/Stranded"Wrecked"=沉没；"Stranded"=搁浅在浅滩或礁石上
其他Miscellaneous无法归类的其他事故

返回参数示例#

{
  "status": 0,
  "msg": "Success",
  "data": [
    {
      "sequence": 1,
      "casualty_id": "91021980046795",
      "ship_name": "CLIPPER",
      "accident_data": "2025-09-17",
      "accident_loaction": "Br.lsles, N.Sea, E.Chnl, Biscay",
      "accident_type": "Fire/Explosion",
      "severity_indicator": "Serious",
      "text": "CAUGHT FIRE WHILST ANCHORED IN GHUBB DIKNAW OFF AS-SALIF, YEMEN IN LAT. 15 17' 31"
    }
  ]
}

注意事项#

查询时间范围通过 start_time 和 end_time 限定，日期格式为 yyyy-MM-dd。
船舶没有历史事故记录时，返回数据为空数组。
accident_type 字段使用英文标准术语，具体含义参考上方事故类型对照表。
severity_indicator 仅区分 Serious（严重）和 Not Serious（非严重）两个级别。
事故描述（text）为原始英文文本，可能包含专业海事术语和坐标信息。

2.4 船舶安全管理证书信息（SMC）#

接口说明：查询指定船舶的安全管理证书（SMC）信息，包括证书类型、审核方、发放方、发放时间和过期时间等。
项目说明
请求地址https://api.shipxy.com/apicall/v3/GetShipSMC
请求方式GET

请求参数#

参数名类型是否必填说明
keystring是船讯网提供的 API Key（授权码）
imouint32是船舶 IMO 编号

请求示例#

https://api.shipxy.com/apicall/v3/GetShipSMC?key=您的APIKEY&imo=9811000

返回参数#

属性标识名称类型说明
data数据数组arraySMC 证书信息列表
└ ship_name船舶名称string船舶名称
└ registry船籍string如 Panama
└ doc_companyDOC 公司名称string如 Chekka Shipping SA
└ certificate_type证书类型string如 Convention
└ certificate_reviewer证书审核方string如 ICS
└ certificate_issuer证书发放方string如 ICS
└ issuance_time发放时间string格式如 2025-03-01
└ expiration_time过期时间string格式如 2025-03-01

返回参数示例#

{
  "status": 0,
  "msg": "Success",
  "data": [
    {
      "ship_name": "示例船名",
      "registry": "Panama",
      "doc_company": "Chekka Shipping SA",
      "certificate_type": "Convention",
      "certificate_reviewer": "ICS",
      "certificate_issuer": "ICS",
      "issuance_time": "2025-03-01",
      "expiration_time": "2025-03-01"
    }
  ]
}

注意事项#

SMC（Safety Management Certificate）是根据 ISM 规则发放的安全管理证书。
certificate_type 通常为 Convention（公约型）或非公约型。
证书审核方（certificate_reviewer）和发放方（certificate_issuer）可能为同一机构，也可能不同。
应注意证书的过期时间（expiration_time），及时提醒用户更新证书信息。

附录：接口速查表#

序号接口名称Endpoint必填参数需要返回参数说明
1船舶安全检查记录（PSC）GetShipPSCkey, imo, start_time, end_time是
2船舶商业变更历史GetShipBusinessHistorykey, imo是
3船舶历史事故记录GetShipAccidentskey, imo, start_time, end_time是
4船舶安全管理证书信息（SMC）GetShipSMCkey, imo是

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location ''

返回响应

⚪0
application/json
Bodyapplication/json

示例
{}
上一页
1.6 船舶档案查询
下一页
2 港口查询