DB3304_T097-2023_政务感知中台数据接口技术规范_嘉兴市 .docxVIP

ICS35.020

CCSL70 3304

浙 江 省 嘉 兴 市 地 方 标 准

DB3304/T097—2023

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

Technicalspecificationofdatainterfaceforgovermentsensingmid-end

DB3304/T097—2023

前

本文件按照GB/T1.1—2020《标准化工作导则

起草。

言

第1部分：标准化文件的结构和起草规则》的规定

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由嘉兴市政务服务和数据资源管理办公室提出并归口。本文件起草单位：平湖市政务服务和数据资源管理办公室、平湖市大数据中心、浙江省大数据发展

中心、平湖市农业农村局、嘉兴市政务服务和数据资源管理办公室、嘉兴市大数据中心、杭州城市大数据运营有限公司、睿哲科技股份有限公司、杭州海康威视数字技术股份有限公司。

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

DB3304/T097—2023

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

1 范围

本文件规定了政务感知中台数据接口的架构、通用要求和接口规范。本文件适用于政务感知中台北向接口和南向接口的设计、开发和维护管理。

2 规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其必威体育精装版版本（包括所有的修改单）适用于本文件。

GB/T33745—2017物联网术语

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

3 术语和定义

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

DB3304/T097—2023

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

省市县一体化智能化公共数据平台

北向接口

服务

服务 服务

数据网关 应用服务 感知资源 算力算法

南向接口

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

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

注：政务感知中台有两类数据接口，北向接口实现与上层应用系统的信息共享与交换；南向接口实现与设备接入平台（物联接入平台和视频接入平台）的感知数据、事件消息的共享与交换。

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

6 数据接口通用要求

DB3304/T097—2023

6.4.2 响应消息通用格式

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

表2 响应消息通用格式

类型 参数名称

响应代码code响应描述msg

响应数据 data

数据类型 说明

string HTTP响应代码，200表示成功string 响应消息描述；

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

7 北向接口规范

7.1 登录与鉴权

7.1.1 手机号验证码登录

手机验证码发送

接口描述：向登录手机号码发送短信验证码。接口地址：/hz-auth-center/mobile/sendIdentifyCode。接口类型：POST。

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

DB3304/T097—2023

表5 请求参数表

参数名称

appKeytimestampsignphoneNumbers

identifyCode

必填 位置

True headTrue headTrue headTrue body

True body

数据类型 说明

string 应用系统的Key，预先统一分配。long 时间戳

string 签名信息，见6.3。string 短信接收号码。

string 手机验证码

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

表6 返回参数表

参数名称access_tokentoken_typerefresh_tokenexpires_in

scope

数据类型 说明string认证Token信息

string 认证Token的类型，默认：bearerstring 刷新Token的安全令牌

string 认证Token的有效期限

string 授权范围，默认：allselect。

7.1.2 根据token获取用户信息

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

DB3304/T097—2023

表8 返回参数表

参数名称 数据类型

data