ICS 65. 020 CCS B41 DB53 云南省地 标准 DB53/T 1379—2025 兽药追溯系统数据接口规范 2025 －05－09 发布 2025-08－09 实施 云南省市场监督管理局 发布 DB53/T 1379—2025 前言 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由云南省农业农村厅提出。 本文件由云南省农业标准化专业技术委员会（YNTCO7）归口。 本文件起草单位：云南省动物卫生监督所、武汉至为科技有限公司、云南省畜牧兽医科学院、怒江 州动物卫生监督所、玉溪市动物卫生监督与疫病预防控制中心。 本文件主要起草人：尹红斌、张永仙、朱尤帅、钱朝海、祥波、和、乔玉洁、李素琳、赵智勇、 李健平、张斌、洪瑞凤、吴小娟、施亚琪、郑欢莉。 I DB53/T 1379—2025 兽药追溯系统数据接口规范 1范围 本文件规定了兽药追溯系统数据接口的设计原则、数据对接范围、数据接口方式、接口列表、接口 测试及安全与隐私保护等内容。 本文件适用于对兽药系统的流通、使用、监管及数据接口的调用。 规范性引用文件 本文件没有规范性引用文件。 3 ，术语和定义 下列术语和定义适用于本文件。 3. 1 数据接口Data Interface 以电子文件的形式实现，计算机软件系统之间传送数据、交换信息的接口。 4数据接口设计原则 4.1标准化原则 接口设计应遵循国家和行业标准，确保数据的兼容性和一致性。 4.2安全性原则 采用加密技术和访问控制策略，保护数据免遭未授权访问或篡改。 4. 3 ，可扩展性原则 接口应具备良好的扩展能力，以适应未来业务发展和技术进步。 4.4高效性原则 优化数据处理流程，减少延迟，提高响应速度 4.5开放性原则 符合产业习惯，兼容主流开源接口，减小接口定制化带来的重新设计、适配成本。 4. 6 ，易用性原则 尽可能设计成抽象程度高、屏蔽底层实现、语法易理解的接口。 ，数据对接范围 1 DB53/T 1379—2025 5.1兽药经营企业数据 兽药经营企业数据及说明见附录A表A.1。 5.2兽药采购数据 兽药采购数据及说明见附录A表A.2。 5.3 兽药销售数据 兽药销售数据及说明见附录A表A.3。 6 数据接口方式 部 调用方身份要求 6.1 应申请对应appid(应用唯一标识） 和appsecret(私钥) 6.2接口传输要求 采用HTTPS协议，接口使用JSON传输数据 地方 6.3 接口要求 API接口应符合以下要求： a) 接口名称：兽药经营企业; b) 接口描述：调用方需申 请对应： 获取兽药经营企业列表； c) 接口地址：接口调用的地址， nttps:/Y{域名}：{ (P 请求方式：POST; e) 接口标识符：/api/query Quarantine; f) 请求参数设计： 1) 在请求参数中，添 I appid 和timestamp, 所有参数按照 ASCII码从小到大排序; 2) 使用 HMAC-SHA256 算法对排序后的字符串和 appsecret 进行加密生成签名 sign; 3) 调用方需要将请求头 leader添 南 g) 返回数据的参数结构说明见表1; h) 接口响应码及状态说明见表 表1 返回参数表基本结构 参数名称 数据类型 是否非空 描述 success boolean 是 接口调用结果 code number 是 接口响应码，见表2 message string 否 接口提示信息 total number 是 查询到的数据总条数，可用于支持数组数据分页 page number 是 返回数据的当前页码 size number 是 返回数据的条数 2 DB53/T 1379—2025 表1 返回参数表基本结构（续） 参数名称 数据类型 是否非空 描述 result array 是 接口调用成功后，返回的数据集 enterprise object 是 接口调用成功后，返回的兽药企业信息对象。 表2接口响应码及状态说明 响应码 状态说明 200 服务器已成功处理请求 401 未获得登录授权或令牌失效 403 服务器拒绝请求 404 500 服务器遇到错误, 无法完成请求 502 服务器作为网关或代理，从上游服务器收到无效响应 503 服务器日前无法使用（由于超载或停机维护） 504 B5 方标准 7接口列表 7. 1 兽药经营企业数据 兽药经营企业数据符合以下要求： a) b) 接口描述：根据附录 ，获取兽药经营企业列 接口地址：https:/ 域名)：{端口) /api/Counterpart/GetNewGrid; (P 请求方式：POST; e) 请求参数设计： 1) 在请求参数中，法 添加 appid timestamp，所有参数推 按照 ASCII 码从小到大排序; 2) 使用_HMAC-SHA256 3) 调用方需要将请求头 header添加 appid 和 sign 和 timestamp。 f) 接口标识符：/api/Counterpart/GetNewGrid g) 请求示例，见附录B。 7. 2 兽药采购数据 兽药采购数据符合以下要求： a) 接口名称：获取兽药采购记录; b) 接口描述：根据附录C参数，获取兽药采购记录； c) 接口地址：https://{域名}：{端口}/api/management/jxc_WareHouse_GSP/grid; (p 请求方式：POST; e) 请求参数设计： 1） 在请求参数中，添加appid和 timestamp，所有参数按照 ASCII 码从小到大排序; 2) 使用 HMAC-SHA256 算法对排序后的字符串和 appsecret 进行加密生成签名 sign; 3