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按
T-GDFCA 021—2019 农贸市场食品追溯系统数据接口规范
文档预览
中文文档
20 页
50 下载
1000 浏览
0 评论
0 收藏
3.0分
温馨提示:本文档共20页,可预览 3 页,如浏览全部内容或当前文档出现乱码,可开通会员下载原始文档
本文档由 思安 于 2022-12-20 17:31:23上传分享