ICS67.040 X01 团体标准 T/GDFCA021—2019 农贸市场食品追溯系统数据接口 规范 Marketofagriculturalproductsfoodtraceabilitysystemdatainterface specification 2019-12-11发布 2019-12-25实施 广东省食品流通协会发布 全国团体标准信息平台 T/GDFCA021—2019 I目  次 前言....................................................................................................................................................................Ⅱ 1范围........................................................................................................................................................................1 2规范性引用文件....................................................................................................................................................1 3术语和定义............................................................................................................................................................1 4缩略语....................................................................................................................................................................1 5数据接口及认证方式............................................................................................................................................1 6数据接口说明........................................................................................................................................................2 7接口验收标准......................................................................................................................................................17 全国团体标准信息平台 T/GDFCA021—2019 II前  言 本标准按照GB/T1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由广东省食品流通协会提出并归口。 本标准主要起草单位:中山市仁达贸易发展有限公司、广州生命码科技有限公司、广州中科易德科 技有限公司、广东省食品流通协会、广州米多网络科技有限公司、深圳天祥质量技术服务有限公司。 本标准主要起草人:钟维维、林进保、陈自英、毛振醒、李兴宇、谢进凯、廖建平、周宝诗、袁令 发。 本标准为首次发布。 全国团体标准信息平台 T/GDFCA021—2019 1农贸市场食品追溯系统数据接口规范 1范围 本标准规定了农贸市场食品追溯系统数据接口的术语和定义、数据接口及认证方式、数据接口说明 以及接口验收标准。 本标准适用于农贸市场食品追溯系统的接入与应用,也可用于指导农贸市场食品追溯系统的开发。 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T1.1-2009标准的结构和编写 GB/T2659-2000世界各国和地区名称代码 GB/T7635.1-2002T全国主要产品分类与代码 3术语和定义 3.1 数据接口 计算机软件系统之间传送数据、交换信息的接口,以电子文件的形式实现。 3.2 JSON JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式,主要用于跟服务器进行交换数据.跟 XML相类似,它独立语言,在跨平台数据传输上有很大的优势。 4缩略语 下列缩略语适用于本文件。 HTTP:超文本传输协议(HyperTextTransferProtocol) JSON:JavaScript对象标记语言(JavaScriptObjectNotation) 5数据接口及认证方式 5.1数据接口范围 农贸市场食品追溯系统应提供一系列接口,包括且不限于:按表单编号溯源接口、按商户编号溯源 接口、商户信息列表接口、市场信息列表接口、产品信息列表接口、我的供应商/客户列表接口、档口 全国团体标准信息平台 T/GDFCA021—2019 2相关品种快检信息查询接口、档口产品列表查询接口、提交保存维权信息接口、查询维权信息列表查询 接口、供应商查询接口。 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按表单编号溯源 a)接口地址:http://serverurl/aquaticProduct/pub.do?action=traceFormNumber b)接口说明:根据请求,调用返回表单相关安全追溯信息 c)接口方式:webservice d)请求格式: method:post content-Type:application/json e)请求参数列表: 表2按表单编号溯源请求参数列表 参数名称 必填 含义 规则说明 traceCode 是 追溯码 字符串 f)请求参数示例: { "traceCode":"追溯码" 全国团体标准信息平台 T/GDFCA021—2019 3} g)返回参数列表: 表3按表单编号溯源返回参数列表 参数名称 类型 说明 code string提示状态码如:1代表成功,2代表失败 message string提示状态说明 data array追溯对象 boothName string档口名称 boothAddress string档口地址 businessRange string经营范围 contactName string供应商名称 accessCertificateIdsstring准入证明 brokerage string经手人 productInfoDTOListarray产品信息 productName string产品名称 total string数量 unitName string包装单位名称 place string产地 uploadLogoId string产品图片id h)返回参数示例: { "status":"1", "message":"成功", "data":{ "boothName":"档口名称", "boothAddress":"档口地址", "businessRange":"经营范围", "contactName":"供应商名称", "accessCertificateIds":"准入证明", "brokerage":"经手人", "productInfoDTOList":[{ "productName":"产品名称", "total":"数量", "unitName":"包装单位名称", "place":"产地", "uploadLogoId":"产品图片id" }] } } 6.2.2按

pdf文档 T-GDFCA 021—2019 农贸市场食品追溯系统数据接口规范

文档预览
中文文档 20 页 50 下载 1000 浏览 0 评论 0 收藏 3.0分
温馨提示:本文档共20页,可预览 3 页,如浏览全部内容或当前文档出现乱码,可开通会员下载原始文档
T-GDFCA 021—2019 农贸市场食品追溯系统数据接口规范 第 1 页 T-GDFCA 021—2019 农贸市场食品追溯系统数据接口规范 第 2 页 T-GDFCA 021—2019 农贸市场食品追溯系统数据接口规范 第 3 页
下载文档到电脑,方便使用
本文档由 思安 于 2022-12-20 17:31:23上传分享
站内资源均来自网友分享或网络收集整理,若无意中侵犯到您的权利,敬请联系我们微信(点击查看客服),我们将及时删除相关资源。