NY
中华人民共和国农业行业标准
NY/T 4713-2025
农产品质量安全追溯 数据接口
Quality andsafety traceabilityof agricultural products-Data interface
中华人民共和国农业农村部 了发布
目 次
前言1范围. 2规范性引用文件3术语和定义4缩略语5设计原则6技术要求 7接口实现8接口安全附录A（资料性） 常见接口错误代码及错误描述附录B（资料性） 接口示例
前言
本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草.
请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的责任.
本文件由农业农村部市场与信总化司提出.
本文件由农业农村部农业信息化标准化技术委员会归口.
本文件起草单位：农业农村部农产品质量安全中心、农业农村部信息中心、北京工商大学、中国农业科林科学院、中国农业科学院饲料研究所、北京市农业农村局、上海市农业农村委员会、福建省农业农村厅、 学院农业资源与农业区划研究所、中国科学院自动化研究所、中国农业科学院农业信息研究所、北京市农北京市农产品质量安全中心、四川省农产品质量安全中心、内蒙古农畜产品质量安全中心、咸都曙光光纤网络有限责任公司、太极计算机股份有限公司、中检计量有限公司、福建有伦农业科技发展有限公司.
本文件主要起草人：孔亮、王子强、张梦飞、刘希艳、韩福军、赵守香、郑火国、张健、潘立刚、谭杰、王杰、慧敏、刘学刚、徐文锦、沈崇胥、同伟、陈能文、牟占山、王亚南、张进. 陈连武、陈炎、林方龙、王全红、云岩春、崔黎、张钰宸、郭征、孙丽娜、任欣欣、周磊、万截军、张锋、路馨丹、徐
农产品质量安全追溯数据接口
1范围
本文件规定了农产品质量安全追溯数据接口的设计原则、技术要求、接口实现和接口安全.本文件适用于农产品质量安全追溯平台建设、平台对接、推广应用、运维服务及监督管理.
2规范性引用文件
下列文件中的内容通过文中的规范性引用面构成本文件必不可少的条款.其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括的修改单）适用于本文件.
GB/T7408.1日期和时间表示法信息交换表示法第1部分：基本原则NY/T4710农产品质量安全追溯术语NY/T4712农产品质量安全追测数据格式RFC 3548 Base16. Base32 和I Base64数据编码(The Base16 Base32. and Base64 Data Encodings) RFC 3629UTF-8 数据转换格式(UTF-8. a transformation format of ISO 10646)
3术语和定义
NY/T4710界定的术语和定义适用于本文件.
4缩略语
下列缩略语适用于本文件.HTTP：超文本传输协议（hypertext transfer protocol)JSON：一种轻量级的数据交换格式（javascript object notation） HTTPS：超文本传输安全协议（hypertext transfer protocol secure）SOAP:简易对象访间协议（simple object access protocol）XML：可扩展标记语言（extensible markup language)
5设计原则
接口设计应遵循以下原则：
a）一致性原则.数据格式、参数命名等保持一致；b）安全性原则.考虑数据加密、身份验证等方面的安全性：e）容错性原则，发生错误时，能够运行并错误信息； d）可扩展性原则.能够随着业务和技术的发展进行灵活调整，满足业务需求变化.
6技术要求
6.1基本要求
6.1.1接口要求
接口通过服务调用实现信息交换，应符合以下要求： a）采用Web Services服务接口；b）采用GB/T7408.1规定的日期类型；c）采用RFC3548规定的Base64编码规则将图片文件转换为字符申：d）采用接口日志方式记录数据异常或数据交换情况.
