ICS65.020.01 CCS B 07 NY 中华人民共和国农业行业标准 NY/T 4063—2021 农业信息系统接口要求 Interface specification for agricultural information system 2021-12-15发布 2022-06-01实施 中华人民共和国农业农村部 发布 NY/T 4063—2021 次 前言 1 范围· 2 规范性引用文件 术语和定义 4 缩略语 5 概述…· 6 接口要求 7 安全机制 8接口调用流程 附录A（资料性) 农业信息系统接口示例 附录B(资料性) 接口地址示例 附录C(资料性) 数据交换包格式示例 NY/T4063—2021 全国农业食品标准 前务言 公共服务 厂食典通 本文件按照GB/T1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任， 本文件由农业农村部市场与信息化司提出。 本文件由农业农村部农业信息化标准化技术委员会归口。 本文件起草单位：北京农业信息技术研究中心、北京农业智能装备技术研究中心、农芯（南京)智慧农 业研究院有限公司。 本文件主要起草人：陈天恩、姜舒文、卢宪祺、陈立平、朱万山、张弛、吴文彪、陈栋、高亮亮、陈阳。 II NY/T4063—2021 农业信息系统接口要求 1范围 本文件规定了农业信息系统的参考体系结构、接口描述、接口要求、安全机制和接口调用流程。 本文件适用于各类农业信息系统模块间接口的设计、开发与应用。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文 件，仅该日期对应的版本适用于本文 注的B文件·其最新版本（ （包括所有的修改单）适用于 SHI 本文件。 RD GB/T7408—2005 信 GB/T22239 息安 Q GB/T26816 数据 GB/T36626 信息 全技术 S 3术语和定义 下列术语利 3. 1 模块 system moduje 具有特定功能 的实体 3. 2 接interfac 泛指实体把 出外部沟通方 法，使其能被内部 而不 3. 3 数据交换包 包含不同业务系统之间需要进 换的数据及数据属性文本 出数据 和数据包体组成，其长 度可变。 3. 4 服务消费者 client 消费和使用服务的程序或信息系统 3.5 服务提供者 server 为服务消费者提供针对性资源服务的服务程序或信息系统。 3.6 中间件middleware 介于应用系统和系统软件之间的一类软件，通过使用系统软件所提供的基础服务（功能），衔接网络上 应用系统的各个部分或不同的应用，达到资源共享、功能共享的日的。 4 缩略语 下列缩略语适用于本文件。 NY/T4063—2021 FTP：文件传输协议（FileTransferProtocol） HTTP：超文本传输协议（HypertextTransferProtocol) JSON:JavaScript对象简谱（JavaScriptObjectNotation） WCS：Web地理覆盖服务（WebCoverageService） WFS：Web地理要素服务（WebFeatureService） WMS：Web地图服务（WebMapService） XML：可扩展标记语言（ExtensibleMarkupLanguage） 5概述 5.1农业信息系统参考体系结构 农业信息系统通常由数据采集模块、数据资源模块、数据分析模块、用户模块、服务模块、能力开放模 块、监控模块组成，参考体系结构如图1所示。 用户模块 能力开放模块 农业政府用户 接口-04数据资源接口 资源交换 接口-02数据共享接口 农业应用主体 接口-03系统基础接口 接口-05服务调用接口 数据发布 科研院所用户 接口-08监控管理接口 接口-08监控管理接口 服务模块 监控模块 业务服务 接口-05服务调用接口 安全管理 资源服务 接口-03系统基础接口 运行维护 基础服务 接口-08监控管理接口 接口-08监控管理接口 数据分析模块 数据资源模块 分析模型 接口-09数据分析接口 接口-04数据资源接口 数据资源目录 接口-06空间信息接口 接口-07系统文件接口 计算引擎 接口-08监控管理接口 数据资源管理 接口-08监控管理接口 数据采集模块 设备装备 农业信息系统终端 接口-01数据获取接口 接口-08监控管理接口 数据库 模块 功能 接口 数据库 图1 农业信息系统参考体系结构 5.1.1数据采集模块 主要包含农业信息系统终端、设备装备的数据获取接口和监控管理接口。 2 NY/T4063—2021 5.1.2数据资源模块 主要包含农业信息系统中各类数据资源目录、数据资源管理的数据资源接口、空间信息接口、系统文 件接口和监控管理接口。 5.1.3数据分析模块 主要包含农业信息系统中各类计算引擎、分析模型的数据分析接口、监控管理接口 5.1.4用户模块 主要包含农业信息系统中农业政府、农业应用主体和科研院所的不同模块级、不同角色用户管理的数 据资源接口、系统基础接口和监控管理接口。 5.1.5服务模块 包含农业信息系统中业务服务 资源服务和基础服务的服务调用接口、系统基础接口和监控管理接 口。 5.1.6能力开放模块 包含农业信息系统中 各装 务调用接口和监控管理接口。 5.1.7监控模块 包含农业信息系统中 5.2接口描述 RES 5.2.1接口分类 本文件定义 存在的逻辑关 联或者物理连按 口分 模块关明 与系统 数据计 监控 接口 接口-01数据 接口-02数据 接口-03系统基 接口-04数据资 R 接口-05服务调用 D 接口-06空间信息接 接口-07系统文件接口 接口-08监控管理接口 接口-09数据分析接口 5.2.2数据获取接口 该类接口为农业信息系统数据获取的通信接口，农业信息系统基础、业务、属性数据应通过农业信息 系统数据采集模块从该类接口获得。 该类接口应支持服务模块基础服务功能对数据属性信息的正确和实时的获取，接口数据包体必须包 含数据包唯一标识和生成时间。该类接口可通过web服务、消息中间件等方式实现数据获取的目的。不 同系统之间数据的获取不建议使用套接字接口。 5.2.3数据共享接口 农业信息系统资源共享模块通过该类接口共享和交换物联网设备装备感知、农业空间信息、农业时 序、文件和农业信息系统基础、业务、属性等数据。 该类接口应提供权限限制和数据加密以保证信息系统安全和稳定，接口数据交换包应采用统一的形 式进行描述，可使用XML、JSON等规范格式。该类接口应根据数据交换包大小选择Web服务（HTTP、 3 NY/T4063—2021 WebService、FTP等）、套接字、消息中间件等接口方式。 该类接口应满足信息共享分类的编码、元数据、远程协议等接口描述要求。其中，接口请求元数据应 满足GB/T26816—2011的5.3中的要求。 5.2.4系统基础接口 农业信息系统各模块通过该类接口进行基础数据和功能调用。 该类接口应仅限农业信息系统各模块内部访问，如非必须，原则上不应对外公开接口地址；若对外开 放接口地址，应对接口描述和接口做好授权等权限限制，以免被恶意请求。 5.2.5数据资源接口 农业信息系统数据资源模块通过该类接口发现、调用和管理农业数据资源。 该类接口应提供资源元数据检索功能和信息资源元数据检索结果提取功能，包含有目录检索接口及 检索接口及资源内容结果提取接口。该类接口宜提供web服务接口，不建议直接使用套接字接口。 5.2.6数据分析接口 农业信息系统服务模块通过该类接口对数据资源发起计算分析和算法模型的调用。 该类接口应提供计算数据集检索、分析计算调用流程描述、分析计算结果提取。该类接口宜提供web 服务接口，不宜直接使用套接字接口。该类接口应提供数据分析模型源文件下载。 5.2.7服务调用接口 农业信息系统通过该类接口在服务模块和资源共享模块进行系统服务的封装和使用。 该类接口应明确服务提供者、服务请求者和服务注册中心，接口应包含接口地址、服务方法以及方法 中参变量的数量、参数名和参数类型说明。应对服务发布方式进行说明，对于web服务调用接口可选择 采用注册中心方式进行发布。 5.2.8空间信息接口 农业信息系统各模块通过该类接口进行农业空间信息的获取，用于访问各种来源和形式的空间地理 信息数据和图像。 该类接口应该包括矢量数据访问接口和栅格数据访问接口，接口应支持WMS、WFS和WCS3种空 间数据互操作的接口。 5.2.9系统文件接口 农业信息系统各模块通过该类接口进行文件的上传、下载和传输。 该类接口必须明确文件的传输方式，对是否允许上传、是否允许下载、支持文件大小、是否支持Ipv6、 登陆限制、授权以及是否允许调试进行说明。 5.2.10监控管理接口 农业信息系统各模块通过该类接口将管理对象、实体和接口的状态信息发送给监控模块，通过该类接 口监控模块对农业信息系统其他功能进行维护、管理和安全保障，保障农业信息系统的稳定、可靠的运行。 该类接口应支持监控模块获取管理对象、实体和接口的状态信息，同时应支持向监控模块发送状态信 息。应支持多种方式与监控模块进行信息交互。应保证获取的管理对象、实体和接口信息的准确性、完整 性和及时性。 6接口要求 6.1通用要求 接口的通用要求，包括以下： a）应实现对外部系统的接入提供支持，在信息系统的高并发和大容量的基础上提供安全可靠的 接入； b）应支持