云南省兽药追溯系统数据接口规范(DB53/T 1379-2025)详细总结

一、标准概述

《兽药追溯系统数据接口规范》(DB53/T 1379-2025)是由云南省农业农村厅提出，云南省农业标准化专业技术委员会归口的省级地方标准。该标准规定了兽药追溯系统数据接口的设计原则、对接范围、接口方式、接口列表、测试方法及安全保护等内容，适用于兽药流通、使用和监管过程中的数据接口调用。

二、主要起草信息

​​起草单位​​：

• 云南省动物卫生监督所(牵头单位)
• 武汉至为科技有限公司
• 云南省畜牧兽医科学院
• 怒江州动物卫生监督所
• 玉溪市动物卫生监督与疫病预防控制中心

​​主要起草人​​：
尹红斌、张永仙、朱尤帅等15位专家

三、核心内容详解

1. 数据接口设计原则

标准提出了6项核心设计原则：

1. ​​标准化原则​​：遵循国家和行业标准，确保数据兼容性和一致性
2. ​​安全性原则​​：采用加密技术和访问控制策略
3. ​​可扩展性原则​​：适应未来业务发展和技术进步
4. ​​高效性原则​​：优化数据处理流程，减少延迟
5. ​​开放性原则​​：兼容主流开源接口，降低适配成本
6. ​​易用性原则​​：设计抽象程度高、语法易理解的接口

2. 数据对接范围

标准明确了三类核心数据对接范围：

(1) 兽药经营企业数据(附录A表A.1)

包含21个数据项，如：

• 企业基本信息(名称、地址、信用代码等)
• 法人信息(姓名、身份证号、联系电话)
• 经营信息(许可证类型、销售模式、职工人数)
• 场所信息(经营面积、仓储地址及面积)
• 负责人信息(仓储负责人、质量负责人及联系方式)

(2) 兽药采购数据(附录A表A.2)

包含14个数据项，如：

• 基础信息(企业名称、供应商名称)
• 时间信息(入库日期、录入时间)
• 药品信息(批准文号、兽药名称、规格)
• 批次信息(批号、生产日期、有效期)
• 数量信息(入库数量、单位)

(3) 兽药销售数据(附录A表A.3)

结构与采购数据类似，主要区别在于业务类型为销售出库

3. 数据接口技术要求

(1) 调用方身份要求

• 需申请appsecret进行身份认证
• 采用HTTPS协议传输
• 数据格式为JSON

(2) 接口安全机制

• 请求参数需添加appid和timestamp
• 所有参数按ASCII码排序
• 使用HMAC-SHA256算法生成签名sign
• 请求头需包含appid、sign和timestamp

(3) 响应结构规范

标准定义了统一的返回参数结构(表1)：

• success: 接口调用结果(boolean)
• code: 响应码(number)
• message: 提示信息(string)
• total: 数据总条数(number)
• page: 当前页码(number)
• size: 返回条数(number)
• result: 数据集(array)
• enterprise: 企业信息对象(object)

(4) 响应码定义(表2)

包括200(成功)、401(未授权)、403(拒绝)、404(未找到)、500(服务器错误)等标准HTTP状态码

4. 核心接口列表

标准定义了三大类接口：

(1) 兽药经营企业数据接口(7.1节)

• ​​接口地址​​: /api/Counterpart/GetNewGrid
• ​​请求方式​​: POST
• ​​输入参数​​: 包含页码、条数、排序方式、企业名称、联系人、区域ID等12项参数(附录B表B.1)
• ​​输出参数​​: 返回25项企业详细信息(附录B表B.2)，包括区域信息、企业资质、地理位置、监管信息等

(2) 兽药采购记录接口(7.2节)

• ​​接口地址​​: /api/management/jxc_WareHouse_GSP/grid
• ​​请求方式​​: POST
• ​​输入参数​​: 包含22项查询条件(附录C表C.1)，如时间范围、药品信息、批号等
• ​​输出参数​​: 返回13项采购详情(附录C表C.2)，包括供应商信息、药品数据、上传状态等

(3) 兽药销售记录接口(7.3节)

• ​​接口地址​​: 同采购接口，通过s_type参数区分
• ​​请求方式​​: POST
• ​​输入参数​​: 21项查询条件(附录D表D.1)
• ​​输出参数​​: 13项销售详情(附录D表D.2)，结构与采购类似，增加处方图片路径字段

5. 接口测试要求

标准规定了完整的测试方案：

1. ​​测试方法​​：使用postman工具通过HTTPS调用测试接口
2. ​​测试过程​​：按文档要求封装参数、生成签名、调用接口
3. ​​测试指标​​：
   • 功能正确性(结果与预期一致)
   • 性能要求(单条查询≤3秒)
   • 参数校验(入参合规性检查)

6. 安全与隐私保护

标准提出三项核心安全要求：

1. ​​访问控制​​：接口需身份验证，按业务开放权限
2. ​​数据脱敏​​：对身份证号、养殖场编号等敏感信息进行脱敏处理
3. ​​传输加密​​：采用国家规定的加密算法保障数据传输安全

四、附录内容

标准包含3个资料性附录：

附录A：数据对接范围

• 表A.1：兽药经营企业数据结构(21字段)
• 表A.2：兽药采购数据结构(14字段)
• 表A.3：兽药销售数据结构(14字段)

附录B：兽药经营企业接口

• 表B.1：输入参数表(12参数)
• 表B.2：输出参数表(25字段)

附录C：兽药采购接口

• 表C.1：输入参数表(22参数)
• 表C.2：输出参数表(13字段)

附录D：兽药销售接口

• 表D.1：输入参数表(21参数)
• 表D.2：输出参数表(13字段)

五、标准特点

1. ​​地域特色​​：针对云南省兽药监管需求定制
2. ​​技术先进​​：采用现代API设计理念和加密技术
3. ​​实用性强​​：提供详细的接口示例和测试方案
4. ​​扩展性好​​：预留了未来业务发展的接口扩展空间
5. ​​安全可靠​​：建立完整的数据安全和隐私保护机制

该标准的实施将有效提升云南省兽药流通的透明度和监管效率，为兽药质量安全追溯提供技术支撑。