ICS 35.080 CCS L 77 3303 温州市 地方标准 DB3303/T 069—2023 渔船安全管理数据服务接口规范 Specification for fishing vessel safety management data service interface 2023 - 09 - 07发布 2023 - 10 - 07实施 温州市市场监督管理局 发布 DB3303/T 069 —2023 I 目次 前言 ................................ ................................ ................. II 1 范围 ................................ ................................ ............... 1 2 规范性引用文件 ................................ ................................ ..... 1 3 术语和定义 ................................ ................................ ......... 1 4 缩略语 ................................ ................................ ............. 1 5 服务接口规则 ................................ ................................ ....... 1 6 数据访问服务接口 ................................ ................................ ... 2 7 数据维护服务接口 ................................ ................................ ... 3 附录A（资料性） 数据目录服务 ................................ ......................... 5 附录B（资料性） 渔船信息结构体格式 ................................ ................... 6 参考文献 ................................ ................................ .............. 7 DB3303/T 069 —2023 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由温州市农业农村局提出及归口。 本文件起草单位：浙江索思科技有限公司、温州市渔业应急处置指挥中心、温州市大数据发展管理 局、温州大学、杭州万国软宝信息科技有限公司、温州市鹿城区大数据管理中心、温州市洞头区大数据 管理中心、乐清市大数据管理中心、永嘉县大数据管理中心、中国移动通信集团浙江有限公司温州分公 司、温州市质量技术检测科学研究院。 本文件主要起草人：王国庆、张笑钦、林志全、卫达、李克祥、洪珏、郑国华、陈辉、雷文理、黄 步统、夏晨 彰、潘国栋、黄海广、王智新、陈晓明、陈月斌、滕飞鹏、陈孝云、潘海华、谢亮、孙夏帆、 陈博、黄小春。 DB3303/T 069 —2023 1 渔船安全管理数据服务接口规范 1 范围 本文件规定了温州籍渔船安全管理数据服务接口规则、数据访问服务接口、数据维护服务接口等内 容。 本文件适用于涉海涉渔单位部门对温州籍渔船安全管理数据的访问和维护。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 11457 信息技术 软件工程术语 3 术语和定义 GB/T 11457 界定的以及下列术语和定义适用于本文件。 渔船安全管理数据 Fishing vessel safety management data 渔船、船员、渔港、气象等基础数据。 海上斑马线信息 Maritime zebra crossing information 温州市海上斑马线系统的数据，包括渔船进出港数据、动态点验数据、点验统计列表等信息。 4 缩略语 下列缩略语适用于本文件。 API：应用程序接口 （Application Programming I nterface ） HTTP：超文本传输协议（ Hypertext Transfer Protocol ） HTTPS：基于SSL的HTTP（Hypertext Transfer Protocol over Secure Socket Layer） SSL：安全套接字层（ Secure Socket Layer） ID：身份标识号（ Identity document ） JSON：JavaScript 对象简谱（ JavaScript Object Notation ） URI：统一资源标识符（ Uniform Resource Identifier) 5 服务接口规则 URI 域名地址 域名地址为 yza.wznync.cn ，替换本文件中 URI的domain部分，以更新数据服务接口的域名地址。 DB3303/T 069 —2023 2 URI版本 API可以在URI中带上版本号。 示例： https:// domain/wz-api/V1.0/* https:// domain/wz-api/V1.2/* https:// domain/wz-api/V2.0/* 数据目录服务 数据目录服务见附录 A。 服务异常 当接收到一个请求时，如果 URI路径错误，将返回一个 HTTPS 404状态码。当接收到一个无效的请 求时，服务将生成一个服务异常报告。该报告用于向客户端应用程序和用户解释请求无效的原因，并通 过使用HTTPS响应码来表示请求的结果。 示例： 200 OK - [GET]：服务器成功返回用户请求的数据。 201 CREATED - [POST/PUT/PATCH] ：用户新建或修改数据成功。 202 Accepted - [*]：表示一个请求已经进入后台排队（异步任务）。 204 NO CONTENT - [DELETE] ：用户删除数据成功。 400 INVALID REQUEST - [POST/PUT/PATCH] ：用户发出的请求有错误，服务器没有进行新建或修改数据的操作，该 操作是幂等的。 401 Unauthorized - [*]：表示用户没有权限（令牌、用户名、密码错误）。 403 Forbidden - [*] 表示用户得到授权（与 401错误相对），但是访问是被禁止的。 404 NOT FOUND - [*]：用户发出的请求针对的是不存在的记录，服务器没有进行操作，该操作是幂等的。 406 Not Acceptable - [GET]：用户请求的格式不可得（比如用户请求 JSON格式，但是只有 XML格式）。 410 Gone -[GET]：用户请求的资源被永久删除，且不会再得到的。 422 Unprocurable entity - [POST/PUT/PATCH] 当创建一个对象时，发生一个验证错误。 500 INTERNAL SERVER ERROR - [*]：服务器发生错误。 6 数据访问服务接口 数据访问机制 数据访问服务接口应符合 HTTPS请求规则，用于用户对平台整合的各类数据服务的浏览、查询、访 问。 ID查询接口 6.2.1 请求规则 接口请求应支持 HTTPS的GET请求方式，按唯一 ID查询业务数据。 示例：如请求获取渔船信息，地址： https://domain/wz -api/V*/ships/{id} 6.2.2 响应规则 DB3303/T 069 —2023 3 服务请求响应后返回 JSON格式的报文。其中各字段若无特别说明均为字符串类型，编码格式为 UTF- 8，日期字段默认格式为 yyyy-MM-dd HH:mm:ss 。 示例： { code:0, 接口响应状态码， 0表示成功， 1表示失败 success:true, true表示数据访问成 功，false表示数据访问失败 msg:"查询成功 ", 成功返回 "查询成功 "，失败返回 "查询失败 " data:{渔船信息结构体 }, 渔船信息数据主体，符合渔船信息结构体格式 t