ICS 35.020 CCS L70 3304 浙江省嘉兴市 地方 标准 DB 3304/T 097—2023 政务感知中台数据接口技术规范 Technical specification of data interface for goverment sensing mid -end 2023 - 06 - 05发布 2023 - 07 - 05实施 嘉兴市市场监督管理局 发布 DB 3304/T 097 —2023 I 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由嘉兴市政务服务和数据资源管理办公室提出并归口。 本文件起草单位：平湖市政务服务和数据资源管理办公室、平湖市大数据中心、浙江省大数据发展 中心、平湖市农业农村局、嘉兴市政务服务和数据资源管理办公室、嘉兴市大数据中心、杭州城市大数 据运营有限公司、睿哲科技股份有限公司、杭州海康威视数字技术股份有限公司。 本文件主要起草人：邬妤琼、金舟、周士飞、李烨、盛春杰、邵洁、濮栋伟、金醇醇、严强、杨国 良、李伟波、徐志欢。 DB 3304/T 097 —2023 1 政务感知中台数据接口技术规范 1 范围 本文件规定了政务感知中台数据接口的架构、通用要求和接口规范。 本文件适用于政务感知中台北向接口和南向接口的设计、开发和维护管理。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本 文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 33745 —2017 物联网 术语 GB/T 36478.1 —2018物联网 信息交换和共享 第1部分：总体架构 3 术语和定义 GB/T 33745 —2018界定的以及下列术语和定义适用于本文件。 3.1 政务感知中台 government sensing mid -end 面向于政务领域感知物联网的中台系统，用于连接感知设备接入平台与应用系统，并提供数据接口 与实现数据交互能力。 4 缩略语 下列缩略语适用于本文件。 HTTP：超文本传输协议（ Hyper Text Transfer Protocol ） HTTPS：超文本传输安全协议 (Hyper Text Transfer Protocol over Secure Socket Layer 或Hyper Text Transfer Protocol Secure ） JSON：轻量级的数据交换格式（ JavaScript Object N otation） 5 数据接口架构 政务感知中台用于连接设备接入平台与应用系统，实现物联网系统间的信息共享和交换，符合 GB/T 36478.1—2018中5.1 b）要求。中台与物联网系统的关系见图１。 DB 3304/T 097 —2023 2 政务感知中台 视频接入平台 物联接入平台 设备 设备 边缘网关 边缘网关... 数据网关应用系统 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 -name string 请求接口的 URL路径 请求方法 POST | GET string 请求方法宜使用 HTTP的POST或GET方法 请求参数 application/json string 请求参数， key-value格式 DB 3304/T 097 —2023 3 6.4.2 响应消息通用格式 在请求/响应模式下，应 遵循统一的 数据接口格式，响应消息格式应符合表 2给出的规范 。 表2 响应消息通用格式 类型 参数名称 数据类型 说明 响应代码 code string HTTP响应代码， 200表示成功 响应描述 msg string 响应消息描述； 响应数据 data string 响应数据内容，通常以 JSON格式返回字符串键值对。 7 北向接口规范 登录与鉴权 7.1 7.1.1 手机号验证码登录 7.1.1.1 手机验证码 发送 接口描述：向登录手机号码发送短信验证码。 接口地址：/hz-auth-center/mobile/sendIdentifyCode 。 接口类型： POST。 请求参数：应符合表 3给出的规范。 表3 请求参数表 参数名称 必填 位置 数据类型 说明 appKey True head string 应用系统的 Key，预先统一分配。 timestamp True head long 时间戳 sign True head string 签名信息，见 6.3。 phoneNumbers True body string 短信接收号码。 返回参数：应符合表 4给出的规范。 表4 返回参数表 参数名称 数据类型 说明 code string 状态码， 200表示成功，其他表示失败。 msg string 接口返回码对应信息。 result string 接口返回的数据，此处是短信验证码。 7.1.1.2 手机验证码认证 接口描述：通过手机号码 +验证码进行登录，验证手机短信验证码是否正确。 接口地址：/hz-auth-center/mobile/token。 接口类型： POST。 请求参数：应符合表 5给出的规范。 DB 3304/T 097 —2023 4 表5 请求参数表 参数名称 必填 位置 数据类型 说明 appKey True head string 应用系统的 Key，预先统一分配。 timestamp True head long 时间戳 sign True head string 签名信息，见 6.3。 phoneNumbers True body string 短信接收号码。 identifyCode True body string 手机验证码 返回参数：应符合表 6给出的规范。 表6 返回参数表 参数名称 数据类型 说明 access_token string 认证Token信息 token_type string 认证Token的类型，默认： bearer refresh_token string 刷新Token的安全令牌 expires_in string 认证Token的有效期限 scope string 授权范围，默认： all select 。 7.1.2 根据token获取用户信息 接口描述：应用系统调用，根据 token获取登录用户信息。 接口地址： /hz-auth-center/auth/user/me/v2/getDetailInfo 。 接口类型： GET。 请求参数：应符合表 7给出的规范。 表7 请求参数表 参数名称 必填 位置 数据类型 说明 appKey True head string 应用系统的 Key，预先统一分配。 timestamp True head long 时间戳 sign True head string 签名信息，见 6.3。 phoneNumbers True body string 短信接收号码，支持向多个手机号码发送短信，多个手机号码以英文 逗号隔开。 一次批量发送上限为 1000。 templateCode True body string 消息模板编号，由消息服务管理员在 "消息服务控制台 "提交消息模板 申请，审核通过后下发该消息模板编号。 templateParams True body string 消息模板各参数内容，以 JSON字符串形式。若没有动态参数，