T/PSC 8-2022 海洋科学数据共享服务规范 接口服务

ICS35.240.01；07.060

CCSL70

团体标准

T/PSC8-2022

海洋科学数据共享服务规范接口服务

Specificationformarinescientificdatasharingservice—Interfaceservice

2022-05-30发布2022-05-30实施

中国太平洋学会发布

T/PSC8-2022

目次

前言.................................................................................II

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4缩略语.............................................................................1

5基本要求...........................................................................1

5.1接口要求.......................................................................1

5.2安全要求.......................................................................2

5.3管理要求.......................................................................2

6接口分类...........................................................................2

7接口描述方法.......................................................................3

7.1接口名称.......................................................................3

7.2接口说明.......................................................................3

7.3接口HTTP请求地址..............................................................3

7.4接口HTTP请求方法..............................................................3

7.5接口HTTP请求参数..............................................................3

7.6接口响应内容...................................................................4

附录A（资料性）海洋科学数据共享服务接口示例.........................................5

附录B（规范性）常用请求参数类型及代码..............................................11

参考文献.............................................................................12

I

T/PSC8-2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由国家海洋信息中心提出。

本文件由中国太平洋学会归口。

本文件起草单位：国家海洋信息中心、国家海洋局北海信息中心、国家海洋局南海信息中心、广西

科学院、大连海洋大学。

本文件主要起草人：吕憧憬、姜晓轶、童心、王漪、孟繁超、田天、唐灵、王子珂、宋恩辉、孙苗、

严小敏、郭俊如、富砚昭。

II

T/PSC8-2022

海洋科学数据共享服务规范接口服务

1范围

本文件规定了海洋科学数据共享服务接口的基本要求、接口分类和接口描述方法。

本文件适用于海洋科学数据共享服务接口的设计研发和共享调用。各类海洋科学数据共享服务平台

（以下简称“平台”）的开发可参考使用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

T/PSC6-2022海洋科学数据共享服务规范数据标识

3术语和定义

下列术语和定义适用于本文件。

3.1

海洋科学数据marinescientificdata

通过观测监测、考察调查、检验检测、试验开发、模式计算、统计核算等方式获取的可用于海洋科

学研究和管理应用等活动的原始数据及其衍生产品。

3.2

海洋科学数据共享服务平台marinescientificdatasharingserviceplatform

提供海洋科学数据及产品查询检索、可视化展示、共享下载、在线计算等功能的数据资源共享交换

平台。

3.3

服务接口serviceinterface

通过网络调用来传输信息的一组程序级的网络通信规则。

4缩略语

下列缩略语适用于本文件。

FTP：文件传输协议（FileTransferProtocol）

HTTP：超文本传输协议（HyperTextTransferProtocol）

IP：网际协议（InternetProtocol）

JSON：JS对象表示法（JavascriptObjectNotation）

UDDI：统一描述、发现和集成协议（UniversalDescriptionDiscoveryandIntegration）

URL：统一资源定位符（UniformResourceLocator）

5基本要求

5.1接口要求

海洋科学数据共享服务接口应满足以下基本要求：

a)接口的描述、注册和发布符合UDDI标准；

1

T/PSC8-2022

b)支持向下兼容升级，降低调用方对服务接口实现的依赖；

c)支持动态弹性扩展，满足服务接口功能的更新迭代需求；

d)符合通用设计要求，能跨操作系统、跨开发语言、跨浏览器调用。

5.2安全要求

海洋科学数据共享服务接口环境安全条件应满足以下基本要求：

a)采用但不限于虚拟网、防火墙、病毒防护等安全技术，防止服务接口被攻击；

b)采用但不限于服务代理、IP地址验证和动态密钥等加密技术，保障点对点数据传输安全；

c)针对安全性要求较高的接口，采用Https或分发密钥的方式提供服务。

5.3管理要求

海洋科学数据共享服务接口管理应满足以下基本要求：

a)在平台中完成注册发布；

b)发布时应提供详细的说明信息，包括但不限于名称、所属类别、访问地址、开放权限、参数

说明和调用示例等；

c)注册、发布、调用、变更及撤销等操作，提前向平台管理员发出请求，平台管理员审核通过

后才能执行操作；

d)变更和撤销前，由平台管理员在平台首页发布公告，并通知服务资源使用方。

6接口分类

服务接口按照功能类型，应包括但不限于数据集管理、数据资源管理、目录清单查询、元数据信息

查询、数据资源获取、服务接口管理、用户管理、权限管理、运行监控和其他等10类，支持按需扩展，

接口分类见表1，部分接口编码及调用示例见附录A。

表1接口分类

序号接口类型接口名称

新增数据集接口

删除数据集接口

1数据集管理类

修改数据集接口

…

新增数据资源接口

删除数据资源接口

2数据资源管理类

修改数据资源接口

…

数据集目录清单查询接口

3目录清单查询类数据目录清单查询接口

…

数据集元数据查询接口

4元数据信息查询类数据元数据查询接口

…

文件在线下载接口

库表资源调用接口

5数据资源获取类

服务地址调用接口

…

注册接口

发布接口

变更接口

6服务接口管理类

撤销接口

审核接口

…

2

T/PSC8-2022

表1接口分类（续）

序号接口类型接口名称

新增用户接口

删除用户接口

7用户管理类修改用户接口

查询用户接口

…

数据集权限管理接口

8权限管理类用户权限管理接口

…

服务运行监控接口

数据资源获取监控接口

9运行监控类