DB63/T 2019-2022 市场监管大数据平台接口规范

ICS01.080.30

CCSL04

DB63

青海省地方标准

DB63/T2019—2022

市场监管大数据平台接口规范

2022-03-10发布2022-04-10实施

青海省市场监督管理局发布

DB63/T2019—2022

目次

前言................................................................................II

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

3.1接口..........................................................................1

3.2协议..........................................................................1

4缩略语............................................................................1

5接口总体要求......................................................................1

5.1接口方式......................................................................1

5.2接口返回数据格式..............................................................1

5.3接口调用地址..................................................................2

5.4部分接口调用参数说明..........................................................2

6统一身份认证接口..................................................................2

6.1获取授权码接口................................................................2

6.2获取访问令牌接口..............................................................2

6.3刷新令牌接口..................................................................3

6.4退出登录接口..................................................................3

7数据上传接口......................................................................4

8数据更新接口......................................................................5

9数据删除接口......................................................................5

10数据查询接口.....................................................................6

I

DB63/T2019—2022

前言

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

草。

本文件由青海省市场监督管理局提出并归口。

本文件主要起草单位：青海省市场监督管理局信息中心。

本文件主要起草人：马玉成、王向文、王逸轩、李瑛、周继辉、何海超、董雪彤、李伟、刘宇静、

汪国孝。

本文件由青海省市场监督管理局监督实施。

II

DB63/T2019—2022

市场监管大数据平台接口规范

1范围

本文件规定了市场监管大数据平台接口总体要求、统一身份认证、数据上传、数据更新、数据删除、

数据查询接口规范。

本文件适用于市场监管业务系统和其它信息系统与市场监管大数据平台之间通过接口进行数据共

享和传输。

2规范性引用文件

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

3术语和定义

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

3.1

接口

进行信息交换时通信双方需要遵从的通信方式和要求。

3.2

协议

服务端和客户端必须共同遵循的一组约定。

4缩略语

下列缩略语适用于本文件。

HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：JavaScript对象标记语言（JavaScriptObjectNotation）

RESTful：REST风格的网络接口

5接口总体要求

5.1接口方式

市场监管大数据平台的接口统一采用RESTful架构风格的Web服务。

接口访问采用HTTPS协议的GET和POST方式。

1

DB63/T2019—2022

5.2接口返回数据格式

接口返回数据采用JSON格式。详见每个接口的详细描述。

5.3接口调用地址

本规范接口调用地址中的“https://ip:port”在实际调用时，需要把其中的“ip”和“port”修

改为市场监管大数据平台提供的真实IP地址和访问端口。

5.4部分接口调用参数说明

dataName：数据对象名称。外部对接系统可以使用的数据对象名称需要在使用前向市场监管大数据

平台申请。如：“食品从业人员信息”、“药品零售企业信息”等。

dataValue：描述一个或多个数据对象实例的JSON字符串。该JSON字符串包含一个数组对象，每个

数组元素是一个数据对象实例。如：

"{

"单位名称":"蜀香火锅店",

"负责人":"张大明"

}"

6统一身份认证接口

6.1获取授权码接口

调用地址：https://ip:port/OAuth/Authorize

调用方式：HTTP的GET方法。

调用参数：见表1。

表1获取授权码接口调用参数

参数名类型必填说明举例

client_id字符串是应用向大数据平台申请的client_id"75ef2134-981b-4

56c-f63c-08d882c

de193"

client_secret字符串是应用向大数据平台申请的client_secret"78juqyes"

scope字符串是应用向大数据平台请求的属性"app"

redirect_uri字符串是认证完成并且用户对应用授权后跳转的地"https://ip:port

址，此地址可以得到grant_code授权码/callback"