ICS 01.080.30 CCS L 04 DB63 青 海 省 地 方 标 准 DB 63/T 2019—2022 市场监管大数据平台接口规范 2022 - 03 - 10 发布 青海省市场监督管理局 2022 - 04 - 10 实施 发 布 DB63/T 2019—2022 目 次 前言 ................................................................................ II 1 范围 .............................................................................. 1 2 规范性引用文件 .................................................................... 1 3 术语和定义 ........................................................................ 1 3.1 接口 .......................................................................... 1 3.2 协议 .......................................................................... 1 4 缩略语 ............................................................................ 1 5 接口总体要求 ...................................................................... 1 5.1 5.2 5.3 5.4 接口方式 ...................................................................... 接口返回数据格式 .............................................................. 接口调用地址 .................................................................. 部分接口调用参数说明 .......................................................... 1 1 2 2 6 统一身份认证接口 .................................................................. 2 6.1 6.2 6.3 6.4 获取授权码接口 ................................................................ 获取访问令牌接口 .............................................................. 刷新令牌接口 .................................................................. 退出登录接口 .................................................................. 2 2 3 3 7 数据上传接口 ...................................................................... 4 8 数据更新接口 ...................................................................... 5 9 数据删除接口 ...................................................................... 5 10 数据查询接口 ..................................................................... 6 I DB63/T 2019—2022 前 言 本文件按照GB/T 1.1-2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起 草。 本文件由青海省市场监督管理局提出并归口。 本文件主要起草单位：青海省市场监督管理局信息中心。 本文件主要起草人：马玉成、王向文、王逸轩、李瑛、周继辉、何海超、董雪彤、李伟、刘宇静、 汪国孝。 本文件由青海省市场监督管理局监督实施。 II DB63/T 2019—2022 市场监管大数据平台接口规范 1 范围 本文件规定了市场监管大数据平台接口总体要求、统一身份认证、数据上传、数据更新、数据删除、 数据查询接口规范。 本文件适用于市场监管业务系统和其它信息系统与市场监管大数据平台之间通过接口进行数据共 享和传输。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 接口 进行信息交换时通信双方需要遵从的通信方式和要求。 3.2 协议 服务端和客户端必须共同遵循的一组约定。 4 缩略语 下列缩略语适用于本文件。 HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over SecureSocket Layer） JSON：JavaScript 对象标记语言（JavaScript Object Notation） RESTful：REST风格的网络接口 5 接口总体要求 5.1 接口方式 市场监管大数据平台的接口统一采用 RESTful 架构风格的 Web 服务。 接口访问采用HTTPS协议的GET和POST方式。 1 DB63/T 2019—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" 值固定为“code” "code" response_type 字符串 是 返回值：JSON对象，对象的属性说明和示例如下。 { "grant_code":"3092" // 获取到的授权码 } 6.2 获取访问令牌接口 调用地址：https://ip:port/OAuth/Access_Token 2 DB63/T 2019—2022 调用方式：HTTP的GET方法。 调用参数：见表2。 表2 获取访问令牌接口调用参数 参数名 类型 必填 说明 举例 client_id 字符串 是 应用向大数据平台申请的client_id "75ef2134-981b-4 56c-f63c-08d882c de193" client_secret 字符串 是 应用向大数据平台申请的client_ secret "78juqyes" scope 字符串 是 应用向大数据平台请求的属性 "app" redirect_uri 字符串 是 认证完成并且用户对应用授权后跳转的地 "https://ip:port 址 /callback" 值固定为“authorization_code” "authorization_c grant_type 字符串 是 ode" code 字符串 是 通过“获取授权码接口”获取到的授权码 "3092" 返回值：JSON对象，对象的属性说明和示例如下。 { "expires_in": 7200, // 令牌有效期，单位“秒” "token_type": "Bearer", // 获得的令牌类型为"Bearer" "access_token": "a23098ca-8584-4d76-f63b-08d882cde193" // 访问令牌 } 6.3 刷新令牌接口 调用地址：https://ip:port/OAuth/Refresh_Token 调用方式：HTTP的GET方法。 调用参数：见表3。 表3 刷新令牌接口调用参数 参数名 类型 必填 说明 举例 client_id 字符串 是 应用向大数据平台申请的client_id "75ef2134-981b-4 56c-f63c-08d882c de193" access_token 字符串 是 访问令牌 "a23098ca-8584-4 d76-f63b-08d882c de193" 返回值：JSON对象，对象的属性说明和示例如下。 { "expires_in": 7200, // 令牌有效期，单位“秒” "token_type": "Bearer", // 获得的令牌类型为"Bearer" "access_token":