DB4403_T 259-2022 电子动物检疫合格证明数据接口规范.docxVIP

ICS35.200CCSL78

DB4403

深圳市地方标准

DB4403/T259—2022

电子动物检疫合格证明数据接口规范

Datainterfacespecificationforelectroniccertificateofanimalquarantine

2022-09-09发布2022-10-01实施

深圳市市场监督管理局发布

I

DB4403/T259—2022

目次

前言 II

1范围 1

2规范性引用文件 1

3术语和定义 1

4数据接口方式 1

5数据调用接口参数 1

附录A（资料性）动物检疫合格证明电子出证数据词典 4

参考文献 9

II

DB4403/T259—2022

前言

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

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由深圳市市场监督管理局提出并归口。

本文件起草单位：深圳市标准技术研究院、深圳市市场监督管理局、深圳市动物卫生监督所。

本文件主要起草人：徐立峰、周哲、刘佳、张碧华、苏巍、郑文科、刘浩、练晓、孙勇、苏晓润、郭静文、林国墩、薛瑶。

1

DB4403/T259—2022

电子动物检疫合格证明数据接口规范

1范围

本文件规定了电子动物检疫合格证明的数据接口方式和数据调用接口参数。本文件适用于企业对电子动物检疫合格证明数据的接口调用。

2规范性引用文件

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

3术语和定义

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

电子动物检疫合格证明electroniccertificateofanimalquarantine

动物卫生监督机构指派官方兽医对动物、动物产品实施检疫后，出具的电子化检疫证明。

4数据接口方式

4.1身份认证要求

调用方需申请对应appid（应用唯一标识）和appsecret（私钥）。4.2接口传输要求

接口使用JSON传输数据，具备通用性和可扩展性。

4.3API接口说明

API接口应符合以下要求：

a)接口名称：电子动物检疫合格证明调用接口；

b)接口描述：调用方需申请对应appid和appsecret，可根据目的地企业统一社会信用代码和检疫证签发日期查询对应的电子动物检疫合格证明申请；

c)接口地址：接口调用的地址；

示例1：/trace/api/api/quarantine/queryQuarantine

d)请求方式：POST；

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

f)请求示例：请求数据的接口地址示例说明；示例2：

body参数{

ddtydm:A5GXLEU29,bz:2022-06-28

}

g）输入参数：访问接口所需的参数，见5.1；h）返回参数：请求反馈的结果，见5.2。

5数据调用接口参数

2

DB4403/T259—2022

5.1输入参数

电子动物检疫合格证明调用接口输入参数及说明见表1。

表1电子动物检疫合格证明调用接口输入参数及说明

输入参数

是否非空

说明

body

ddtydm

是

目的地企业统一社会信用代码

bz

是

检疫证签发日期（日期格式yyyy-mm-dd）

header

nonce

是

随机串（不少于10位）

appid

是

分配每个调用方1个appid和1个appsecret

timestamp

是

时间戳

signature

是

计算方式：appid、appsecret、nonce、timestamp四个参数按ASCII排序，即

appid=xxxxxappsecret=xxxxxxxnonce=xxxxxxxxxxtimestamp=xxxxxxxx，计算MD5值转大写

5.2返回参数

电子动物检疫合格证明调用接口返回参数及说明见表2。

表2电子动物检疫合格证明调用接口返回参数及说明

返回参数

是否非空

说明

result

jyzh

是

检疫证号（10-11位检疫证号）

jyzlb

是

动物检疫合格证明类别代码见表A.1

zt

是

状态（1正常、3作废、4超期）

hz

是

货主

hzCode

否

货主企业动检证列表查看码

hztydm

是

货主统一社会信用代码

hzdh

是