DB3303/T 069-2023 渔船安全管理数据服务接口规范

ICS35.080

CCSL77

3303

温州市地方标准

DB3303/T069—2023

渔船安全管理数据服务接口规范

Specificationforfishingvesselsafetymanagementdataservice

interface

2023-09-07发布2023-10-07实施

温州市市场监督管理局发布

DB3303/T069—2023

目次

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

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

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

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

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

5服务接口规则.......................................................................1

6数据访问服务接口...................................................................2

7数据维护服务接口...................................................................3

附录A（资料性）数据目录服务.........................................................5

附录B（资料性）渔船信息结构体格式...................................................6

参考文献..............................................................................7

I

DB3303/T069—2023

前言

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

起草。

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

本文件由温州市农业农村局提出及归口。

本文件起草单位：浙江索思科技有限公司、温州市渔业应急处置指挥中心、温州市大数据发展管理

局、温州大学、杭州万国软宝信息科技有限公司、温州市鹿城区大数据管理中心、温州市洞头区大数据

管理中心、乐清市大数据管理中心、永嘉县大数据管理中心、中国移动通信集团浙江有限公司温州分公

司、温州市质量技术检测科学研究院。

本文件主要起草人：王国庆、张笑钦、林志全、卫达、李克祥、洪珏、郑国华、陈辉、雷文理、黄

步统、夏晨彰、潘国栋、黄海广、王智新、陈晓明、陈月斌、滕飞鹏、陈孝云、潘海华、谢亮、孙夏帆、

陈博、黄小春。

II

DB3303/T069—2023

渔船安全管理数据服务接口规范

1范围

本文件规定了温州籍渔船安全管理数据服务接口规则、数据访问服务接口、数据维护服务接口等内

容。

本文件适用于涉海涉渔单位部门对温州籍渔船安全管理数据的访问和维护。

2规范性引用文件

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

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

文件。

GB/T11457信息技术软件工程术语

3术语和定义

GB/T11457界定的以及下列术语和定义适用于本文件。

渔船安全管理数据Fishingvesselsafetymanagementdata

渔船、船员、渔港、气象等基础数据。

海上斑马线信息Maritimezebracrossinginformation

温州市海上斑马线系统的数据，包括渔船进出港数据、动态点验数据、点验统计列表等信息。

4缩略语

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

API：应用程序接口（ApplicationProgrammingInterface）

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

HTTPS：基于SSL的HTTP（HypertextTransferProtocoloverSecureSocketLayer）

SSL：安全套接字层（SecureSocketLayer）

ID：身份标识号（Identitydocument）

JSON：JavaScript对象简谱（JavaScriptObjectNotation）

URI：统一资源标识符（UniformResourceIdentifier)

5服务接口规则

URI域名地址

域名地址为，替换本文件中URI的domain部分，以更新数据服务接口的域名地址。

1

DB3303/T069—2023

URI版本

API可以在URI中带上版本号。

示例：

https://domain/wz-api/V1.0/*

https://domain/wz-api/V1.2/*

https://domain/wz-api/V2.0/*

数据目录服务

数据目录服务见附录A。

服务异常

当接收到一个请求时，如果URI路径错误，将返回一个HTTPS404状态码。当接收到一个无效的请

求时，服务将生成一个服务异常报告。该报告用于向客户端应用程序和用户解释请求无效的原因，并通

过使用HTTPS响应码来表示请求的结果。

示例：

200OK-[GET]：服务器成功返回用户请求的数据。

201CREATED-[POST/PUT/PATCH]：用户新建或修改数据成功。

202Acce