ICS67.040 X01 团体标准 T/GDFCA018—2019 水产品流通追溯系统数据接口规范 Aquaticproductcirculationtraceabilitysystemdatainterface specification 2019-12-18发布 2019-12-25实施 广东省食品流通协会发布 全国团体标准信息平台 T/GDFCA018—2019 I目  次 前言......................................................................................................................................................................Ⅱ 1范围........................................................................................................................................................................1 2规范性引用文件....................................................................................................................................................1 3术语和定义............................................................................................................................................................1 4缩略语....................................................................................................................................................................1 5数据接口及认证方式............................................................................................................................................1 6数据接口说明........................................................................................................................................................2 7接口验收标准......................................................................................................................................................11 全国团体标准信息平台 T/GDFCA018—2019 II前  言 本标准按照GB/T1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由广东省食品流通协会提出并归口。 本标准起草单位：中山市仁达贸易发展有限公司、广东泰利旺生物科技发展有限公司、广州中科易 德科技有限公司、广东省食品流通协会、广州生命码科技有限公司、广州米多网络科技有限公司、深圳 天祥质量技术服务有限公司。 本标准主要起草人：林进保、向阳芬、朱宏、陈自英、毛振醒、崔明月、李兴宇、谢进凯、廖建平、 周宝诗、云育行。 本标准为首次发布。 全国团体标准信息平台 T/GDFCA018—2019 1水产品流通追溯系统数据接口规范 1范围 本标准规定了水产品流通追溯系统数据接口的术语和定义、数据接口及认证方式、数据接口说明以 及接口验收标准。 本标准适用于水产品流通追溯系统的接入与应用，也可用于指导水产品流通追溯系统的开发。 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T1.1-2009标准的结构和编写 GB/T2659-2000世界各国和地区名称代码 GB/T7635.1-2002T全国主要产品分类与代码 3术语和定义 下列术语和定义适用于本文件。 3.1 数据接口Datainterface 计算机软件系统之间传送数据、交换信息的接口，以电子文件的形式实现. 3.2 水产品流通追溯系统Aquaticproducttraceabilitysystem 水产品流通追溯系统能够连接水产品生产、检验、监管和消费各个环节，让消费者了解符合卫生安 全的生产和流通过程，提高消费者放心程度。 4缩略语 下列缩略语适用于本文件。 HTTP：超文本传输协议（HyperTextTransferProtocol） JSON：JavaScript对象标记语言（JavaScriptObjectNotation） 5数据接口及认证方式 5.1数据接口范围及内容 水产品流通追溯系统应提供一系列的接口，应包括且不限于如图所示功能： 全国团体标准信息平台 T/GDFCA018—2019 2 图1水产品流通追溯系统数据接口范围 5.2认证方式 本系统中，接口使用方在调用数据接口前必须经过认证，接口提供方需提供认证接口给接口使用方 进行认证操作。接口提供方为每个接口使用方分配应用标识和凭据，接口使用方调用认证接口，通过应 用标识和凭据获取具有一定时效性的有效令牌，之后调用数据接口均需带上该令牌。 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/GDFCA018—2019 36.2.2备案接口函数 6.2.2.1节点备案 a)接口说明:对水产品流通市场上的节点进行备案。 b)接口地址:http://serverurl/aquaticProduct/nodeInfo.do?action=add c)请求方式:post。 d)请求参数列表: 表2节点备案请求参数列表 参数 是否必填 说明 数据类型 nodeName 是 节点名称 字符串 nodeAddress 是 节点经营地址 字符串 areaCode 是 所属区域代码 字符串 areaName 是 所属区域名称 字符串 nodeType 是 节点类型 字符串 nodeStatus 是 节点状态（正常、已禁用） 字符串 registerDate 是 备案日期时间 时间 nodePhone 是 联系电话 字符串 nodeContacts是 联系人 字符串 entName 是 企业名称 字符串 entLegal 是 企业法人 字符串 entCreditCode是 企业统一社会信用代码 字符串 entRegisterCode是 企业工商注册号 字符串 entAddress 是 企业地址 字符串 entScope 是 企业经营范围 字符串 remark 是 备注 字符串 e)请求参数示列: { "nodeName":"步步高超市", "nodeAddress":"广东省广州市白云区增槎路926号", "areaCode":"440111", "areaName":"广州市白云区" "nodeType":"连锁超市", "nodeStatus":"正常", "registerDate":"2019-09-2510:23:23", "nodePhone":"135XXXXXXXX", "nodeContacts":"黎小姐", "entName":"广州步步高有限公司", "entLegal":"叶灿江", "entCreditCode":"914401117397104228", "entRegisterCode":"440101000086873", "entAddress":"广东省广州市白云区增槎路926号", 全国团体标准信息平台 T/GDFCA018—2019 4"entScope":"鲜活水产品、冰冻水产品、干制品",