DB3304/T 097-2023 政务感知中台数据接口技术规范

ICS35.020

CCSL70

3304

浙江省嘉兴市地方标准

DB3304/T097—2023

政务感知中台数据接口技术规范

Technicalspecificationofdatainterfaceforgovermentsensingmid-end

2023-06-05发布2023-07-05实施

嘉兴市市场监督管理局发布

DB3304/T097—2023

前言

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

起草。

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

本文件由嘉兴市政务服务和数据资源管理办公室提出并归口。

本文件起草单位：平湖市政务服务和数据资源管理办公室、平湖市大数据中心、浙江省大数据发展

中心、平湖市农业农村局、嘉兴市政务服务和数据资源管理办公室、嘉兴市大数据中心、杭州城市大数

据运营有限公司、睿哲科技股份有限公司、杭州海康威视数字技术股份有限公司。

本文件主要起草人：邬妤琼、金舟、周士飞、李烨、盛春杰、邵洁、濮栋伟、金醇醇、严强、杨国

良、李伟波、徐志欢。

I

DB3304/T097—2023

政务感知中台数据接口技术规范

1范围

本文件规定了政务感知中台数据接口的架构、通用要求和接口规范。

本文件适用于政务感知中台北向接口和南向接口的设计、开发和维护管理。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T33745—2017物联网术语

GB/T36478.1—2018物联网信息交换和共享第1部分：总体架构

3术语和定义

GB/T33745—2018界定的以及下列术语和定义适用于本文件。

3.1

政务感知中台governmentsensingmid-end

面向于政务领域感知物联网的中台系统，用于连接感知设备接入平台与应用系统，并提供数据接口

与实现数据交互能力。

4缩略语

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

HTTP：超文本传输协议（HyperTextTransferProtocol）

HTTPS：超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketLayer或Hyper

TextTransferProtocolSecure）

JSON：轻量级的数据交换格式（JavaScriptObjectNotation）

5数据接口架构

政务感知中台用于连接设备接入平台与应用系统，实现物联网系统间的信息共享和交换，符合GB/T

36478.1—2018中5.1b）要求。中台与物联网系统的关系见图１。

1

DB3304/T097—2023

应用系统1应用系统2...应用系统n

省

市

县北向接口

一

体政务感知中台

化

智

能感知资源算力算法

数据网关应用服务

化服务服务

公

共

数

据南向接口

平

台

物联接入平台视频接入平台

设备边缘网关设备边缘网关

注：政务感知中台有两类数据接口，北向接口实现与上层应用系统的信息共享与交换；南向接口实现与设备接入平

台（物联接入平台和视频接入平台）的感知数据、事件消息的共享与交换。

图1政务感知中台接口架构

6数据接口通用要求

6.1通信协议

政务感知中台的数据接口宜支持请求/响应模式，宜使用HTTP、HTTPS协议，优先采用加密传输。

6.2消息队列

政务感知中台的数据接口宜支持发布/订阅模式，如Kafka消息队列，优先采用加密传输。

6.3接口签名与认证

应用系统在调用数据接口时，应在请求消息头（如HTTP的head）包含与对appKey和appSecret的签

名信息sign；appKey和appSecret在应用系统向中台注册时统一分配，签名信息sign宜通过对appKey、

appSecret和timestamp进行MD5运算得出。

6.4请求/响应接口格式

6.4.1请求消息通用格式

在请求/响应模式下，应遵循统一的数据接口格式，请求消息格式应符合表1给出的规范。

表1请求消息通用格式

类型参数名称数据类型说明

请求路径path/interface-namestring请求接口的URL路径

请求方法POST|GETstring请求方法宜使用HTTP的POST或GET方法

请求参数application/jsonstring请求参数，key-value格式

2

DB3304/T097—2023

6.4.2响应消息通用格式

在请求/响应模式下，应遵循统一的数据接口格式，响应消息格式应符合表2给出的规范。

表2响应消息通用格式

类型参数名称数据类型说明

响应代码codestringHTTP响应代码，200表示成功

响应描述msgstring响应消息描述；

响应数据datastring响应数据内容，通常以JSON格式返回字符串键值对。

7北向接口规范

7.1登录与鉴权

7.1.1手机号验证码登录

手机验证码发送

接口描述：向登录手机号码发送短信验证码。

接口地址：/hz-auth-center/mobile/sendIdentifyCode。

接口类型：POST。

请求参数：应符合表3给出的规范。

表3请求参数表

参数名称必填位置数据类型说明

appKeyTrueheadstring应用系统的Key，预先统一分配。

timestampTrueheadlong时间戳

signTrueheadstring签名信息，见6.3。

phoneNumbersTruebodystring短信接收号码。

返回参数：应符合表4给出的规范。

表4返回参数表

参数名称数据类型说明

codestring状态码，200表示成功，其他表示失败。

msgstring接口返回码对应信息。

resultstring接口返回的数据，此处是短信验证码。

手机验证码认证

接口描述：通过手机号码+验证码进行登录，验证手机短信验证码是否正确。

接口地址：/hz-auth-center/mobile/token。

接口类型：POST。

请求参数：应符合表5给出的规范。

3

DB3304/T097—2023

表5请求参数表

参数名称必填位置数据类型说明

appKeyTrueheadstring应用系统的Key，预先统一分配。

timestampTrueheadlong时间戳

signTrueheadstring签名信息，见6.3。

phoneNumbersTruebodystring短信接收号码。

identifyCodeTruebodystring手机验证码

返回参数：应符合表6给出的规范。

表6返回参数表

参数名称数据类型说明

access_tokenstring认证Token信息

token_typestring认证Token的类型，默认：bearer

refresh_tokenstring刷新Token的安全令牌

expires_instring认证Token的有效期限

scopestring授权范围，默认：allselect。

7.1.2根据token获取用户信息

接口描述：应用系统调用，根据token获取登录用户信息。

接口地址：/hz-auth-center/auth/user/me/v2/getDetailInfo。

接口类型：GET。

请求参数：应符合表7给出的规范。

表7请求参数表

参数名称必填位置数据类型说明

appKeyTrueheadstring应用系统的Key，预先统一分配。

timestampTrueheadlong时间戳

signTrueheadstring签名信息，见6.3。

短信接收号码，支持向多个手机号码发送短信，多个手机号码以英文

phoneNumbersTruebodystring

逗号隔开。一次批量发送上限为1000。

消息模板编号，由消息服务管理员在"消息服务控制台"提交消息模板

templateCodeTruebodystring

申请，审核通过后下发该消息模板编号。

消息模板各参数内容，以JSON字符串形式。若没有动态参数，直接传

templateParamsTruebodystring

空字符串。

消息签名编号，由消息服务管理员在"消息服务控制台"提交消息签名

signIdTruebodystring