T/PSC 8-2022 海洋科学数据共享服务规范 接口服务 Specification for marine scientific data sharing service —Interface service 2022- 05 - 30发布 2022- 05 -30实施 中国太平洋学会 发布 ICS 35.240.01；07.060 CCS L 70 团体标准 全国团体标准信息平台 全国团体标准信息平台 T/PSC 8-2022 I 目次 前言 ................................ ................................ ................. II 1 范围 ................................ ................................ ............... 1 2 规范性引用文件 ................................ ................................ ..... 1 3 术语和定义 ................................ ................................ ......... 1 4 缩略语 ................................ ................................ ............. 1 5 基本要求 ................................ ................................ ........... 1 接口要求 ................................ ................................ ....... 1 5.1 安全要求 ................................ ................................ ....... 2 5.2 管理要求 ................................ ................................ ....... 2 5.3 6 接口分类 ................................ ................................ ........... 2 7 接口描述方法 ................................ ................................ ....... 3 接口名称 ................................ ................................ ....... 3 7.1 接口说明 ................................ ................................ ....... 3 7.2 接口HTTP请求地址 ................................ .............................. 3 7.3 接口HTTP请求方法 ................................ .............................. 3 7.4 接口HTTP请求参数 ................................ .............................. 3 7.5 接口响应内容 ................................ ................................ ... 4 7.6 附录A（资料性） 海洋科学数据共享服务接口示例 ................................ ......... 5 附录B（规范性） 常用请求参数类型及代码 ................................ .............. 11 参考文献 ................................ ................................ ............. 12 全国团体标准信息平台 T/PSC 8-2022 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由国家海洋信息中心提出。 本文件由中国太平洋学会归口。 本文件起草 单位：国家海洋信息中心、国家海洋局北海信息中心、国家海洋局南海信息中心、广西 科学院、大连海洋大学。 本文件主要起草人： 吕憧憬、姜晓轶、童心、王漪、孟繁超、田天、唐灵、王子珂、宋恩辉、孙苗、 严小敏、郭俊如、富砚昭 。 全国团体标准信息平台 T/PSC 8-2022 1 海洋科学数据共享服务规范 接口服务 1 范围 本文件规定了海洋科学数据共享服务接口的基本要求、接口分类和接口描述方法。 本文件适用于海洋科学数据共享服务接口的设计研发和共享调用。 各类海洋科学数据共享服务平台 （以下简称“平台”）的开发可参考 使用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 T/PSC 6-2022 海洋科学数据共享服务规范 数据标识 3 术语和定义 下列术语和定义适用于本文件。 3.1 海洋科学数据 marine scien tific data 通过观测监测、考察调查、检验检测、试验开发、模式计算、统计核算等方式获取的可用于海洋科 学研究和管理应用等活动的原始数据及其衍生产品。 3.2 海洋科学数据共享服务平台 marine scientific data sharing service platform 提供海洋科学数据 及产品查询检索、可视化展示、共享下载、在线计算等功能的数据资源 共享交换 平台。 3.3 服务接口 service interface 通过网络调用来传输信息的一组程序级的网络通信规则。 4 缩略语 下列缩略语适用于本文件。 FTP：文件传输协议（ File Transfer Protocol ） HTTP：超文本传输协议（ Hyper Text Transfer Protocol ） IP：网际协议（ Internet Protocol ） JSON：JS对象表示法（ Javascript Object Notation ） UDDI：统一描述、发现和集成协议（ Universal Description Discovery and Integration ） URL：统一资源定位符（ Uniform Resource Locator ） 5 基本要求 接口要求 5.1 海洋科学数据共享服务接口 应满足以下基本要求： a) 接口的描述、注册和发布符合 UDDI标准； 全国团体标准信息平台 T/PSC 8-2022 2 b) 支持向下兼容升级，降低调用方对服务接口实现的依赖； c) 支持动态弹性扩展，满足服务接口功能的更新迭代需求； d) 符合通用设计要求，能跨操作系统、跨开发语言、跨浏览器调用。 安全要求 5.2 海洋科学数据共享服务接口环境安全条件应满足以下基本要求： a) 采用但不限于虚拟网、防火墙、病毒防护等安全技术，防止服务接口被攻击； b) 采用但不限于服务代理、 IP地址验证和动态密钥等加密技术，保障点对点数据传输安全； c) 针对安全性要 求较高的接口，采用 Https或分发密钥的方式提供服务。 管理要求 5.3 海洋科学数据共享服务接口管理应满足以下基本要求： a) 在平台中完成注册发布； b) 发布时应提供详细的说明信息，包括但不限于名称、所属类别、访问地址、开放权限、参数 说明和调用示例等； c) 注册、发布、调用、变更及撤销等操作，提前向平台管理员发出请求， 平台管理员审核通过 后才能执行操作； d) 变更和撤销前，由平台管理员在平台首页发布公告，并通知服务资源使用方。 6 接口分类 服务接口按照功能类型，应包括但不限于数据集管理、数据资源管理、目录清单查询、元数据信息 查询、数据资源获取、服务接口管理、用户管理、权限管理、运行监控和其他等 10类，支持按需扩展， 接口分类见表 1，部分接口编码及调用示例见附录 A。 表1 接口分类 序号 接口类型 接口名称 1 数据集管理类 新增数据集接口 删除数据集接口 修改数据集接口 … 2 数据资源管理类 新增数据资源接口