Shipxy
    • 概述
    • 注册与创建应用
    • 多语言SDK引入
    • AI大模型接入MCP服务
    • 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
    • 2 港口查询
      • 2.1 港口信息查询
        GET
      • 2.2 港口当前靠泊船查询
        GET
      • 2.3 港口当前到锚船查询
        GET
      • 2.4 港口预抵船舶查询
        GET
    • 3 历史行为
      • 3.1 船舶历史轨迹查询
        GET
      • 3.2 船舶互相搭靠记录查询
        GET
    • 4 挂靠记录
      • 4.1 船舶历史挂靠记录
        GET
      • 4.2 船舶挂靠指定港口记录
        GET
      • 4.3 船舶当前挂靠信息
        GET
      • 4.4 港口挂靠历史船舶
        GET
    • 5 航线规划
      • 5.1 点到点航线规划
        GET
      • 5.2 港到港航线规划
        GET
      • 5.3 预计到达时间(ETA)查询
        GET
    • 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 海区气象
        GET
      • 6.6 单点海洋气象
        GET
      • 6.7 历史气象记录
        GET
    • 7 海图应用
      • 7.1 船位光栅瓦片
      • 7.2 港口位置瓦片
    • 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 船舶搭靠事件推送
    • 文档附录
      • 船舶类型对照表
      • 服务码返回说明
      • 海区对照表
      • 航行状态对照表
      • 绕航节点清单
      • 航标类型对照表

    注册与创建应用

    1.注册与登录#

    1.
    打开船讯网,进入API首页
    image (1).png
    点击注册进入注册页面,如果已经有船讯网账号,可以直接点击登录船讯网账号。登录了船讯网账号,可以直接创建应用。
    image (2).png
    注册账号:您可以通过访问船讯网首页或直接进入船讯网API控制台进行注册。
    image (3).png
    登录:注册完成后,使用您的账号和密码登录API控制台。
    image (4).png
    注意:需要注意船讯网客户中已经接入过旧版本api的,还是需要去老用户目前已经接入api的入口。
    image (5).png

    2.创建应用Key#

    1.
    进入应用管理模块:登录后,进入API新版本控制台中的“应用管理”模块。
    image (6).png
    创建应用Key:点击“创建应用”,填写相关信息后生成应用Key。选择创建试用的key可以具备一定的初始权限,辅助做一些功能性的测试。 如果您要正式使用我们船讯网的服务,开通更多的服务权限,请创建正式的key并联系商务。 已经开通正式key的也可以再创建试用key,一个账户最多有一个试用的key。
    image (7).png
    创建完的key,点击复制按钮,可以直接将key复制出来,如果是测试账号可以直接使用key调用基础服务,如果需要额外开通权限,把key发给您对接的销售人员即可。
    image (8).png

    权限说明:#

    1.
    一个账户最多可以注册5个应用Key。
    第一个注册的应用Key具备初始测试权限,可用于基本功能测试。
    其他应用Key需要联系商务团队开通权限。

    3.发送请求与接收数据#

    1.
    拼接HTTP请求URL:根据API文档,拼接HTTP请求URL,并将申请的Key作为必填参数一同发送。
    接收数据:发送请求后,接收HTTP请求返回的数据,数据格式为JSON或二进制。
    解析数据:解析返回的数据,根据业务需求进行处理。

    4.推送类服务的使用#

    1.
    创建监控船队:在控制台中创建需要监控的船队,并关联对应的推送权限。
    image (9).png
    image (10).png
    绑定接收URL:提前绑定您接收推送消息的URL,确保能够接收实时推送数据。
    image (11).png
    设置推送服务:区域提醒推送服务需要配置参数,如监控全部船舶、按分类筛选或自有船队进出提醒等。
    image (12).png
    image (13).png

    5.注意事项#

    1.
    数据格式:确保请求的数据格式符合API文档的要求,避免因格式问题导致请求失败或数据解析错误。
    权限管理:合理管理应用Key的权限,避免权限滥用或不足影响业务运行。

    6.联系我们#

    1.
    开通权限:如果需要为其他应用Key开通权限,或需要更多高级功能,请联系商务团队。
    联系方式:
    邮箱:support@shipxy.com
    电话:400-010-8558
    技术支持:如在使用过程中遇到问题,可联系船讯网技术支持团队获取帮助。
    邮箱:service@shipxy.com
    修改于 2026-06-20 02:29:07
    上一页
    概述
    下一页
    多语言SDK引入
    Built with