DB53/T 1379-2025 兽药追溯系统数据接口规范

ICS65.020

CCSB41

53

云南省地方标准

DB53/T1379—2025

兽药追溯系统数据接口规范

2025-05-09发布2025-08-09实施

云南省市场监督管理局  发布

DB53/T1379—2025

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由云南省农业农村厅提出。

本文件由云南省农业标准化专业技术委员会（YNTC07）归口。

本文件起草单位：云南省动物卫生监督所、武汉至为科技有限公司、云南省畜牧兽医科学院、怒江

州动物卫生监督所、玉溪市动物卫生监督与疫病预防控制中心。

本文件主要起草人：尹红斌、张永仙、朱尤帅、钱朝海、瞿祥波、和塍、乔玉洁、李素琳、赵智勇、

李健平、张斌、洪瑞凤、吴小娟、施亚琪、郑欢莉。

I

DB53/T1379—2025

兽药追溯系统数据接口规范

1范围

本文件规定了兽药追溯系统数据接口的设计原则、数据对接范围、数据接口方式、接口列表、接口

测试及安全与隐私保护等内容。

本文件适用于对兽药系统的流通、使用、监管及数据接口的调用。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

下列术语和定义适用于本文件。

3.1

数据接口DataInterface

以电子文件的形式实现,计算机软件系统之间传送数据、交换信息的接口。

4数据接口设计原则

4.1标准化原则

接口设计应遵循国家和行业标准，确保数据的兼容性和一致性。

4.2安全性原则

采用加密技术和访问控制策略，保护数据免遭未授权访问或篡改。

4.3可扩展性原则

接口应具备良好的扩展能力，以适应未来业务发展和技术进步。

4.4高效性原则

优化数据处理流程，减少延迟，提高响应速度。

4.5开放性原则

符合产业习惯，兼容主流开源接口，减小接口定制化带来的重新设计、适配成本。

4.6易用性原则

尽可能设计成抽象程度高、屏蔽底层实现、语法易理解的接口。

5数据对接范围

1

DB53/T1379—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)接口描述：调用方需申请对应appid和appsecret，获取兽药经营企业列表；

c)接口地址：接口调用的地址，如“https://{域名}:{端口}/api/queryQuarantine”；

d)请求方式：POST；

e)接口标识符：/api/queryQuarantine；

f)请求参数设计:

1)在请求参数中，添加appid和timestamp，所有参数按照ASCII码从小到大排序；

2)使用HMAC-SHA256算法对排序后的字符串和appsecret进行加密生成签名sign；

3)调用方需要将请求头header添加appid和sign和timestamp。

g)返回数据的参数结构说明见表1；

h)接口响应码及状态说明见表2。

表1返回参数表基本结构

参数名称数据类型是否非空描述

successboolean是接口调用结果

codenumber是接口响应码，见表2

messagestring否接口提示信息

totalnumber是查询到的数据总条数，可用于支持数组数据分页

pagenumber是返回数据的当前页码

sizenumber是返回数据的条数

2

DB53/T1379—2025

表1返回参数表基本结构（续）

参数名称数据类型是否非空描述

resultarray是接口调用成功后，返回的数据集

enterpriseobject是接口调用成功后，返回的兽药企业信息对象。

表2接口响应码及状态说明

响应码状态说明

200服务器已成功处理请求

401未获得登录授权或令牌失效

403服务器拒绝请求

404服务器找不到请求的接口或页面

500服务器遇到错误，无法完成请求

502服务器作为网关或代理，从上游服务器收到无效响应

503服务器目前无法使用（由于超载或停机维护）

504服务器作为网关或代理，但是没有及时从上游服务器收到请求

7接口列表

7.1兽药经营企业数据

兽药经营企业数据符合以下要求：

a)接口名称：兽药经营企业；

b)接口描述：根据附录B参数，获取兽药经营企业列表；

c)接口地址：https://{域名}:{端口}/api/Counterpart/GetNewGrid；

d)请求方式：POST；

e)请求参数设计:

1)在请求参数中，添加appid和timestamp，所有参数按照ASCII码从小到大排序；

2)使用HMAC-SHA256算法对排序后的字符串和appsecret进行加密生成签名sign；

3)调用方需要将请求头header添加appid和sign和timestamp。

f)接口标识符：/api/Counterpart/GetNewGrid；

g)请求示例，见附录B。

7.2兽药采购数据

兽药采购数据符合以下要求：

a)接口名称：获取兽药采购记录；

b)接口描述：根据附录C参数，获取兽药采购记录；

c)接口地址：https://{域名}:{端口}/api/management/jxc_WareHouse_GSP/grid；

d)请求方式：POST；

e)请求参数设计:

1)在请求参数中，添加appid和timestamp，所有参数按照ASCII码从小到大排序；

2)使用HMAC-SHA256算法对排序后的字符串和appsecret进行加密生成签名sign；

3

DB53/T1379—2025

3)调用方需要将请求头header添加appid和sign和timestamp。

f)接口标识符：/api/management/jxc_WareHouse_GSP/grid；

g)请求示例，见附录C。

7.3兽药销售数据

兽药销售数据符合以下要求：

a)接口名称：获取兽药销售记录；

b)接口描述：根据附录D参数，获取兽药销售记录；

c)接口地址：https://{域名}:{端口}/api/management/jxc_WareHouse_GSP/grid；

d)请求方式：POST；

e)请求参数设计:

1)在请求参数中，添加appid和timestamp，所有参数按照ASCII码从小到大排序；

2)使用HMAC-SHA256算法对排序后的字符串和appsecret进行加密生成签名sign；

3)调用方需要将请求头header添加appid和sign和timestamp。

f)接口标识符：/api/management/jxc_WareHouse_GSP/grid；

g)请求示例，见附录D。

8接口测试

8.1测试方法

提供测试接口地址，接口使用https传输协议交互，使用postman调用接口测试。

8.2测试过程

按照文档要求封装接口参数，生成接口签名，调用接口。

8.3测试指标

接口返回结果，结果与预期一致，接口的响应时间应在可接受的范围内（单条查询数据3秒以内），

对入参合规性做校验。

9安全与隐私保护

9.1接口访问需经过身份验证，针对业务开放相关接口。

9.2对敏感信息如身份证号、养殖场编号、申请单位编号等应进行脱敏处理。

9.3在数据传输过程中按国家规定的加密算法。

4

DB53/T1379—2025

A

A

附录A

（资料性）

数据对接范围

A.1兽药经营企业数据及说明

兽药经营企业数据及说明见表A.1。

表A.1兽药经营企业数据及说明

序号数据项名称数据类型字节备注

1cp_full_namestring200兽药经营企业名称

2area_fullnamestring200省市区乡镇

3cp_addressstring200详细地址

4ybstring20邮编

5build_datedatetime20成立时间

6credit_codestring30统一社会信用代码

7responsorstring50法人代表

8id_nostring50身份证号

9responsory_phonestring20法人联系电话

10jyfwstring200经营范围

11jyxkz_jylxstring20经营许可证经营类型

12xsmsstring20销售模式

13employee_numnumber10职工人数

14cp_addressstring200经营地址

15jysite_areanumber10经营场所面积

16cangchu_adressstring200仓储地址

17