ICS07.060 CCSA45 中华人民共和国海洋行业标准 HY/T0484—2025 海洋应用软件集成规范 接口 Specificationforoceanicapplicationsoftwareintegration—Interface 2025-02-06发布 2025-05-01实施 中华人民共和国自然资源部发布自然资源标准化信息服务平台 专用目 次 前言 Ⅲ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语、定义和缩略语 1 ……………………………………………………………………………………… 3.1 术语和定义 1 ………………………………………………………………………………………… 3.2 缩略语 2 ……………………………………………………………………………………………… 4 接口基本要求 2 …………………………………………………………………………………………… 5 接口编码 2 ………………………………………………………………………………………………… 5.1 接口类型 2 …………………………………………………………………………………………… 5.2 权限开放级别 2 ……………………………………………………………………………………… 5.3 编码方式 2 …………………………………………………………………………………………… 5.4 参数格式 3 …………………………………………………………………………………………… 6 接口调用 4 ………………………………………………………………………………………………… 6.1 调用类型 4 …………………………………………………………………………………………… 6.2 调用安全 4 …………………………………………………………………………………………… 附录A(资料性) 海洋应用软件集成接口示例 6 ………………………………………………………… 附录B(资料性) XML和JSON格式说明及返回参数示例 10 ………………………………………… B.1 概述 10 ………………………………………………………………………………………………… B.2 XML格式说明及返回参数样例 10 ………………………………………………………………… B.3 JSON格式说明及返回参数样例 11 ………………………………………………………………… 参考文献 13 …………………………………………………………………………………………………… ⅠHY/T0484—2025自然资源标准化信息服务平台 专用 自然资源标准化信息服务平台 专用前 言 本文件按照GB/T1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中华人民共和国自然资源部提出。 本文件由全国海洋标准化技术委员会(SAC/TC283)归口。 本文件起草单位:国家海洋信息中心、自然资源部北海海域海岛中心、南宁师范大学、广西壮族自治 区海洋研究院。 本文件主要起草人:姜晓轶、吕憧憬、曹丽娟、刘金、曹盛文、孙苗、蒋冰、郭雪、康林冲、宋丽丽、 许贵林、黄乐、李焰、邬满、文莉莉、符昱。 ⅢHY/T0484—2025自然资源标准化信息服务平台 专用 自然资源标准化信息服务平台 专用海洋应用软件集成规范 接口 1 范围 本文件规定了海洋应用软件集成接口的基本要求、类型、格式、调用规范等,并给出了接口编码结构 的说明。 本文件适用于海洋应用软件整合集成,以及各海洋应用软件之间的服务资源、业务数据、用户信息 等接口资源的共享交换。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文 件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于 本文件。 GB32100 法人和其他组织统一社会信用代码编码规则 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 安全认证接口 securityauthenticationinterface 为海洋应用软件集成提供的用户单点登录/登出、用户访问权限校验等接口。 3.1.2 地图服务接口 mapserviceinterface 一种利用地理信息软件制作并发布的、符合开放地理空间信息标准的、可以通过网络进行地图资源 调用的接口。 注:主要包括地图要素、切片地图、遥感影像、空间分析等服务接口。 3.1.3 资源调用接口 resourceinvocationinterface 海洋应用软件集成和对外提供的资源共享和交换接口。 注:主要包括数据资源、开发组件和模式算法等资源调用服务接口。 3.1.4 界面集成接口 portalintegrationinterface 为海洋应用软件门户界面集成提供的开放接口。 3.1.5 Web服务 webservice 网络分布式计算环境中提供基础功能的应用程序。 [来源:DB37/T2761.3—2016,3.3,有修改] 1HY/T0484—2025自然资源标准化信息服务平台 专用 3.2 缩略语 下列缩略语适用于本文件。 HTTP 超文本传输协议(HypertextTransferProtocol) JSON 对象表示法(JavaScriptObjectNotation) UDDI 统一描述、发现和集成协议(UniversalDescriptionDiscoveryandIntegration) URL 统一资源定位符(UniformResourceLocator) XML 可扩展标记语言(ExtensibleMarkupLanguage) 4 接口基本要求 为确保软件集成与信息交互的稳定性、便捷性和可扩展性,海洋应用软件集成接口满足以下基本 要求: a) 所有接口的描述、注册和发布应符合UDDI标准; b) 仅提供Web服务接口调用; c) 应符合高内聚、低耦合的接口封装要求,某一接口的变更不影响其他接口的调用; d) 应符合向下兼容的接口升级要求,接口更新时应尽可能保留其对外公布的调用地址、函数名、 输入输出参数等,降低原接口调用者更新和维护的成本; e) 海洋应用软件并发增加、移除或更新时,接口应支持动态扩展和平滑移植; f) 应支持对接口请求响应的动态控制,确保接口高并发调用的流畅与稳定; g) 宜支持跨语言、跨操作系统的接口调用; h) 应支持与国土空间信息基础平台之间的接口调用。 5 接口编码 5.1 接口类型 接口按照功能类型,主要包括安全认证接口、地图服务接口、资源调用接口和界面集成接口4类,支 持按需扩展,安全认证接口示例参见附录A中的表A.1~表A.5、地图服务接口示例参见表A.6~表 A.7、资源调用接口示例参见表A.8~表A.10、界面集成接口示例参见表A.11。 5.2 权限开放级别 接口应定义其权限开放级别,包括以下2类: ———调用完全公开类接口,不必对调用者身份和权限进行验证; ———调用依权限公开类接口,应对调用者身份和权限进行安全验证。 5.3 编码方式 为确保海洋应用软件和接口的唯一性,其编码应遵循统一的命名规则。 海洋应用软件应采用“‘软件缩写(6位,首字母大写)’+‘_’+‘统一社会信用代码(18位)’”共25 位混合码的方式编码,其中,软件缩写宜使用软件的英文单词或汉语拼音首字母缩写,统一社会信用代 码应符合GB32100的规定(见示例1)。 示例1:“海洋综合监管平台”的软件编码为“Hyjgpt_121000004013602937”,其中“Hyjgpt”为系统中文名称首字母缩 写,“121000004013602937”为该应用软件承建单位统一社会信用代码。 接口名称应采用帕斯卡命名法编码,宜使用英文单词命名,不宜使用汉语拼音或拼音缩写,每个单 2HY/T0484—2025自然资源标准化信息服务平台 专用