智慧农业（接口设计）

智慧农业（接口设计）

外部接口

外部接口指各字系统接收外部数据使用的通讯接口。外部数据包括大田土壤养分信息、用水数据、农业气象数据等。外部数据通过外部接口入平台会进行格式验证，统一数据结构等一系列操作。

（外部接口示意图）

数据库：高标准良田管理系统 精细化节水灌溉预报系统 农业气象灾害监测预警系统

外部接口：格式验证、统一数据结构、传感器状态校验、数据异常校验、数据解析入库

对应有作物信息、土壤数据 、用水数据

外部数据分为结构化数据和非结构化数据，结构化数据包括传感器所采集得时效数据，非结构化数据包括地理空间数据、视频流、卫星遥感图像等。

1. 对于格式化数据的处理：通过外部接口首先将验证格式是否属于结构化数据，接着将结构化数据统一

解析并转换为XML文件，此操作的目的是为了兼容多种厂家的数据格式。之后进行统一的传感器状态校验、数据异常校验、解析时效数据和数据入库。

1. 对于非结构化数据的处理：通过外部接口首先将验证格式确定该非结构化数据的类型，随后数据类型进入到图像识别或GIS渲染等模块中进行数据处理。

内部接口

内部接口指系统后台与前端交互时使用Restful规范接口。由于平台架构采用前后端分离的设计思想，故系统后台向前端提供标准的Restful接口，并将数据整理为Json格式进行数据传输。

前端可使用Ajax技术进行异步请求。为了保证数据的传输安全，传输信道使用SSL加密。

内部接口提供了一套完整的权限认证流程：

1. 用户通过的内部接口并根据接口文档使用正确的请求格式和参数发起请求，请求中携带的令牌信息用于确认请求合法性和用户权限，确认通过后进行指定的后续业务操作，并最终响应需要的Josn数据。确认未通过则响应拒绝处理的Json数据。

（内部数据流图）

1. 内部接口的数据格式：

Json格式3个字段，msg字段表达响应状态的描述性文字；code字段为状态码，0代表成功，-1代表异常或拒绝处理；data字段则包括此次请求需要的核心数据。