TFDSA 020-2021 重大活动食品安全情报研判系统接口规范.pdf

ICS35.240.50CCS X 07团体标准T/FDSA 0202021重大活动食品安全情报研判系统接口规范Specification for interface of food safety information research andjudgment system for major event2021-11-30 发布2021-12-30 实施中国食品药品企业质量安全促进会发布中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 0202021目次前言.1范围.12规范性引用文件.13术语和定义.14缩略语.15接口技术要求.16接口调用方式.26.1请求.26.2返回.27接口定义格式.28接口原则.28.1基本要求.28.2公共原则.29接口整体架构.210数据接口.310.1数据访问接口定义.310.2数据新增、修改、删除、查询接口定义.411业务接口.611.1食品合格预测接口定义.611.2食品中毒害危险物最大限量值预警接口定义.811.3食品安全风险图神经网络预警接口定义.911.4食品安全知识图谱问答系统接口定义.1011.5基于 LSTM 的毒害危险物风险预测接口定义.11附录 A（规范性）接口返回代码值.14附录 B（资料性）接口调用示例.15中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 0202021前言本文件按照 GB/T 1.12020标准化工作导则 第 1 部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由北方工业大学提出。本文件由中国食品药品企业质量安全促进会归口。本文件起草单位：北方工业大学、中国人民公安大学、北京工业大学、江苏华安博远检测技术有限公司。本文件主要起草人：史运涛、李书钦、董哲、王力、李志军、田华伟、李晓理、王康、蒋维嘉、李春雷、殷翔、周萌、李杰、丁瑜。中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 02020211重大活动食品安全情报研判系统接口规范1范围本规范规定了重大活动食品安全情报研判系统的接口技术要求、接口调用方式、接口定义格式、接口原则、接口整体架构、数据接口和业务接口。本规范适用于重大活动食品安全情报研判系统的建设与管理。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T 5271.9信息技术词汇 第9部分：数据通信3术语和定义GB/T 5271.9界定的以及下列术语和定义适用于本文件。3.1重大活动major event具有一定社会影响力、需要公共卫生监督和警务保障的各项高规格的政治、经济、文化、体育等活动。4缩略语下列缩略语适用于本文件。HTTP：超文本传输协议（Hypertext Transfer Protocol）JDBC：Java数据库连接（Java Database Connectivity）JSON：JavaScript对象标记（JavaScript Object Notation）LSTM：长短期记忆网络（Long-Short Term Memory）SQL：结构化查询语言（Structured Query Language）URL：统一资源定位符（Uniform Resource Locators）XML：可扩展置标语言（eXtensible Markup Language）5接口技术要求毒害危险物数据库、案例数据库、第三方数据库及实时监测数据应通过本文件定义的通用访问接口，为情报研判系统软件提供数据访问和管理功能，其技术要求如下：毒害危险物数据库应提供农药、兽药、添加剂、生物毒素、微生物、污染物、致癌物、化学危险品、非法添加物等数据的高效存取功能，支持情报实时分析研判；中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 02020212案例数据库应提供刑事案例数据的高速访问功能，支持对案发时间、案发地点、受害人、案件信息等的在线分析研判；第三方数据库应提供重点人员、社会媒体、电商平台、物流、话单、通行、交易等数据的快速查询功能，支持对舆情演化、电商交易等数据的分析计算；实时监测数据应提供现场快检设备检测数据、重大活动食品安全相关事件信息、辅助决策系统推送的情报信息等实时动态数据。6接口调用方式6.1请求应通过HTTP请求格式调用数据库服务接口，并将请求参数包含在请求的URL中。6.2返回调用成功后应以XML或JSON格式返回结果，调用失败时返回相应的错误信息。7接口定义格式情报研判系统的接口定义如下：a)接口名：接口的名称；b)描述：对接口内容的描述；c)参数：请求调用的参数；d)返回值：请求返回的内容；e)错误信息：调用错误时返回的信息。8接口原则8.1基本要求系统间接口应满足下列基本要求：在系统的高并发和大容量的基础上提供安全可靠的接入；提供接入有效性校验机制，如验证参数个数、类型、值域范围等；接口设计遵循可扩展原则；接口设计提供调用安全校验机制，以确保接口的安全性。8.2公共规则所有接口应满足下列规则：接口统一采用基于 HTTP 1.1 协议的消息交互；HTTP 方法兼容 HTTP 1.1 协议，统一采用 POST 方法；请求和应答统一采用 UTF-8 编码方式；接口返回代码采用统一代码表示，见附录 A。9接口整体架构中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 02020213情报研判系统接口架构见表1。表 1情报研判系统接口架构接口类型接口名数据接口数据访问数据新增数据修改数据删除数据查询业务接口食品合格预测食品中毒害危险物最大限量值预警食品安全风险图神经网络预警食品安全知识图谱问答系统基于LSTM的毒害危险物风险预测10数据接口10.1数据访问接口定义10.1.1接口描述情报研判系统采用JDBC访问数据库，使用JDBC访问数据库的基本步骤如下：a)加载 JDBC 驱动程序；b)建立数据库连接；c)创建操作数据库 SQL 的对象；d)执行语句并分析执行结果；e)关闭连接。10.1.2接口参数描述情报研判系统通过 JDBC 访问 MySQL 数据库的 Url 参数描述见表 2。表 2数据访问接口参数描述参数名称参数说明user数据库用户名，用于连接数据库password用户密码，用于连接数据库useUnicode是否使用Unicode字符集，如果参数characterEncoding设置为gb2312、gbk或utf8,本参数的值必须设置为truecharacterEncodinguseUnicode为true时，指定字符编码，比如可以设置为gb2312、gbk或utf8autoReconnect当数据库连接异常中断时，是否重新连接autoReconnectForPools是否使用针对数据库连接池的重连策略failOverReadOnly自动重连成功后，连接是否设置为只读maxReconnectsautoReconnect设置为true时，重试连接的次数initialTimeoutautoReconnect设置为true时，两次重连之间的时间间隔，单位：秒中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 02020214表 2（续）参数名称参数说明connectTimeout和数据库服务器建立socket连接时的超时，单位：毫秒。0表示永不超时，适用于JDK 1.4及更高版本scoketTimeout网络套接字连接的超时（默认值0表示无超时）示例：情报研判系统通过JDBC访问MySQL数据库：jdbc:mysql:/localhost:3306/foodDb?user=root&password=&useUnicode=true&characterEncoding=gbk&autoReconnect=true&failOverReadOnly=false10.1.3接口调用规则调用时序如图1所示。图 1数据访问接口时序图10.1.4接口调用使用Java语言来进行接口调用，调用示例见附录B（示例1）。10.2数据新增、修改、删除、查询接口定义10.2.1接口描述10.2.1.1 新增数据新增接口描述见表3。表 3数据新增接口描述接口描述说明函数名称save功能描述在毒害危险物数据库、案例数据库中新增数据前置条件为对应的数据对象实体赋值输入参数数据对象实体输出参数1）处理结果2）异常描述中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 0202021510.2.1.2 修改数据修改接口描述见表4。表 4数据修改接口描述接口描述说明函数名称update功能描述在毒害危险物数据库、案例数据库中修改数据前置条件为对应的数据对象实体赋值输入参数数据对象实体输出参数1）处理结果2）异常描述10.2.1.3 删除数据删除接口描述见表5。表 5数据删除接口描述接口描述说明函数名称delete功能描述在毒害危险物数据库、案例数据库中删除数据前置条件取得要删除数据对象的id输入参数数据对象实体的id输出参数1）处理结果2）异常描述10.2.1.4 查询数据查询接口描述见表6。表 6数据查询接口描述接口描述说明函数名称show功能描述在毒害危险物数据库、案例数据库、第三方数据库、实时监测数据中查询数据前置条件取得要查询数据对象的id输入参数数据对象实体的id输出参数1）处理结果2）异常描述10.2.2接口调用规则调用时序如图2所示。中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 02020216图 2数据接口时序图10.2.3接口调用使用Java语言来进行接口调用，接口调用示例见附录B（示例2、示例3、示例4、示例5）。11业务接口11.1食品合格预测接口定义11.1.1接口描述根据某段时间内某一食品的抽检数据，输入任一批次的食品特征数据，预测其是否合格。食品合格预测接口描述见表7。表 7食品合格预测接口描述接口描述说明函数名称forecast接口方式HttpPost接口协议HttpPost功能描述输入任一批次的食品特征数据，预测其是否合格前置条件食品合格预测模型已部署输入参数1）食品亚类2）规格3）生产时间4）企业类型5）生产省份6）异地运输输出参数1）预测结果2）模型信息中国食品药品企业质量安全促进会中国食品药品企业质量安全促进会全国团体标准信息平台T/FDSA 0202021711.1.2接口参数描述食品合格预测接口参数描述见表8。表 8食品合格预测接口参数描述参数名称参数说明输入/输出参数类型取值范围是否必须参数示例foodCategory食 品 亚类输入string050个字符是食品亚类/分类specification规格输入string050个字符是散装称重/预包装productionTime生 产 时间输入string050个字符是第一季度/第二季度/第三季度/第四季度enterpriseType企业类型输入string050个字符是公司/店铺produceProvince生产省份输入string050个字符是所有省份longDistanceTransportation异地运输输入string050个字符是是/否result预 测 结果输出string050个字符是合格/不合格modelInfo模 型 信息输出string1000个字符是模型名称,训练集精度,测试集精度,正确率,精准率,召回率,调和平均值,权重优化器,激活函数,隐层数量及神经元个数示例：根据表8