复制页面
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首页
点击注册进入注册页面,如果已经有船讯网账号,可以直接点击登录船讯网账号。登录了船讯网账号,可以直接创建应用。
注册账号:您可以通过访问船讯网首页或直接进入船讯网API控制台进行注册。
登录:注册完成后,使用您的账号和密码登录API控制台。
注意:需要注意船讯网客户中已经接入过旧版本api的,还是需要去老用户目前已经接入api的入口。
2.创建应用Key
#
1.
进入应用管理模块:登录后,进入API新版本控制台中的“应用管理”模块。
创建应用Key:点击“创建应用”,填写相关信息后生成应用Key。选择创建试用的key可以具备一定的初始权限,辅助做一些功能性的测试。 如果您要正式使用我们船讯网的服务,开通更多的服务权限,请创建正式的key并联系商务。 已经开通正式key的也可以再创建试用key,一个账户最多有一个试用的key。
创建完的key,点击复制按钮,可以直接将key复制出来,如果是测试账号可以直接使用key调用基础服务,如果需要额外开通权限,把key发给您对接的销售人员即可。
权限说明:
#
1.
一个账户最多可以注册5个应用Key。
第一个注册的应用Key具备初始测试权限,可用于基本功能测试。
其他应用Key需要联系商务团队开通权限。
3.发送请求与接收数据
#
1.
拼接HTTP请求URL:根据API文档,拼接HTTP请求URL,并将申请的Key作为必填参数一同发送。
接收数据:发送请求后,接收HTTP请求返回的数据,数据格式为JSON或二进制。
解析数据:解析返回的数据,根据业务需求进行处理。
4.推送类服务的使用
#
1.
创建监控船队:在控制台中创建需要监控的船队,并关联对 应的推送权限。
绑定接收URL:提前绑定您接收推送消息的URL,确保能够接收实时推送数据。
设置推送服务:区域提醒推送服务需要配置参数,如监控全部船舶、按分类筛选或自有船队进出提醒等。
5.注意事项
#
1.
数据格式:确保请求的数据格式符合API文档的要求,避免因格式问题导致请求失败或数据解析错误。
权限管理:合理管理应用Key的权限,避免权限滥用或不足影响业务运行。
6.联系我们
#
1.
开通权限:如果需要为其他应用Key开通权限,或需要更多高级功能,请联系商务团队。
联系方式:
邮箱:
support@shipxy.com
电话:400-010-8558
技术支持:如在使用过程中遇到问题,可联系船讯网技术支持团队获取帮助。
邮箱:
service@shipxy.com
修改于
2026-06-20 02:29:07
上一页
概述
下一页
多语言SDK引入