ICS67.040 X01 团体标准 T/GDFCA020—2019 超市食品追溯系统数据接口规范 Supermarketfoodtraceabilitysystemdatainterfacespecification 2019-12-11发布 2019-12-25实施 广东省食品流通协会发布 全国团体标准信息平台 T/GDFCA020—2019 I目  次 前言......................................................................................................................................................................II 1范围........................................................................................................................................................................1 2规范性引用文件....................................................................................................................................................1 3术语和定义............................................................................................................................................................1 4缩略语....................................................................................................................................................................1 5数据接口及认证方式............................................................................................................................................1 6数据接口说明........................................................................................................................................................2 7接口验收标准......................................................................................................................................................12 全国团体标准信息平台 T/GDFCA020—2019 II前  言 本标准按照GB/T1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由广东省食品流通协会提出并归口。 本标准主要起草单位：中山市仁达贸易发展有限公司、广东泰利旺生物科技发展有限公司、广州中 科易德科技有限公司、广东省食品流通协会、广州生命码科技有限公司、广州米多网络科技有限公司、 华润万家有限公司、深圳天祥质量技术服务有限公司。 本标准主要起草人：林进保、向阳芬、朱宏、陈自英、毛振醒、崔明月、李兴宇、谢进凯、廖建平、 周宝诗、张国鸿、钟朝君。 本标准为首次发布。 全国团体标准信息平台 T/GDFCA020—2019 1超市食品追溯系统数据接口规范 1范围 本标准规定了超市食品追溯系统数据接口的术语和定义、数据接口及认证方式、数据接口说明以及 接口验收标准。 本标准适用于超市食品追溯系统的接入与应用，也可用于指导超市食品追溯系统的开发。 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T1.1-2009标准的结构和编写 GB/T2659-2000世界各国和地区名称代码 GB/T7635.1-2002T全国主要产品分类与代码 3术语和定义 下列术语和定义适用于本文件。 3.1 数据接口Datainterface 计算机软件系统之间传送数据、交换信息的接口，以电子文件的形式实现。 3.2 超市食品追溯系统Supermarketfoodtraceabilitysystem “超市食品追溯系统”是一个能够连接超市食品生产、检验、监管和消费各个环节，让消费者了解符 合卫生安全的生产和流通过程，提高消费者放心程度的信息管理系统。 4缩略语 下列缩略语适用于本文件。 HTTP：超文本传输协议（HyperTextTransferProtocol） JSON：JavaScript对象标记语言（JavaScriptObjectNotation） 5数据接口及认证方式 5.1数据接口范围及内容 超市食品追溯系统应提供一系列的接口，应包括且不限于如图所示功能： 全国团体标准信息平台 T/GDFCA020—2019 2 图1超市食品追溯系统接口范围 5.2认证方式 本系统中，接口使用方在调用数据接口前必须经过认证，接口提供方需提供认证接口给接口使用方 进行认证操作。接口提供方为每个接口使用方分配应用标识和凭据（authID和authKey），接口使用方 调用认证接口，通过应用标识和凭据获取具有一定时效性的有效令牌，之后调用数据接口均需带上该令 牌。 6数据接口说明 6.1数据格式 本系统需采用JSON作为系统间的数据传输格式，调用接口时请求数据和返回数据均采用JSON格式。 系统中传输的数据格式如表1所示，在定义参数类型时只能从这六种类型中选取。 表1数据传输格式 类型 格式 示例 字符 字符串 userName:“张三” 数字 整型、浮点型 age:24 日期 YYYY-MM-DD birthday:“1983-12-05” 时间 YYYY-MM-DD HH:mm:sscreateTime:“1983-12-0513:05:00” 数组 列表 data：[{11,12},{21,22}] 布尔型 布尔型 isDeleted:“false” 6.2超市节点管理接口 6.2.1概述 超市节点管理接口用于管理食品追溯系统上登记的超市节点。 主要功能应包括查询超市节点列表、保存超市节点信息、禁用（启用超市节点）。 全国团体标准信息平台 T/GDFCA020—2019 36.2.2超市节点管理接口函数 6.2.2.1查询超市节点列表 a)接口说明：提供对超市节点的模糊查询，返回查询所得超市节点。 b)接口地址：http://serverurl/superMarket/circulateNode.do?action=list c)请求方式：post。 a)请求参数列表：见表2。 表2查询超市节点列表接口请求参数列表 参数 是否必填 说明 数据类型 nodeCode 否 节点编码 字符串 nodeNameLike 否 节点名称模糊 字符串 areaCode 否 所属区域代码 字符串 nodeType 否 节点类型 字符串 nodeStatus 否 节点状态("正常","已禁用")字符串 registerDateFrom 否 备案日期开始时间 时间 registerDateTo 否 备案日期结束时间 时间 nodePhoneLike 否 联系电话模糊 字符串 nodeContactsLike 否 联系人模糊 字符串 entNameLike 否 企业名称模糊 字符串 entLegalLike 否 企业法人模糊 字符串 entCreditCodeLike否 企业统一社会信用代码模糊字符串 entRegisterCodeLike否 企业工商注册号模糊 字符串 rows 是 每页记录数 数字 page 是 第几页 数字 sortName 是 排序名 字符串 sortOrder 是 升降序（asc、desc） 字符串 b)返回参数说明：见表3。 表3查询超市节点列表接口返回参数列表 参数 说明 数据类型 Code 状态码：成功返回0，失败返回非0数字 Message 状态说明 数字 dataPage 页码 数字 Total 返回记录数 数字 Records 总记录数 数字 rowsid 主键id 数字 nodeCode 节点编码，上传时后台自动生成字符串 nodeName 节点名称 字符串 nodeAddress 节点经营地址 字符串 areaCode 所属区域代码 字符串 全国团体标准信息平台 T/GDFCA020—2019 4areaName 所属区域名称 字符串 nodeType 节点类型（连锁超市）