DB3502/T 福 建 省 厦 门 市 地 方 标 准 DB3502/T 049.1—2019 公共安全管理平台信息资源交换规范 第 1 部分：接口服务 Specification of information resource exchange for public security management platform—Part 1 : Interface services 2019 - 09 -10 发布 厦门市市场监督管理局 2019 - 10 - 01 实施 发 布 DB3502/T 049.1—2019 目 次 前言 ................................................................................ II 1 范围 .............................................................................. 1 2 规范性引用文件 .................................................................... 1 3 术语和定义 ........................................................................ 1 4 缩略语 ............................................................................ 1 5 基本框架 .......................................................................... 2 6 接口定义 .......................................................................... 2 7 交换数据项值域 ................................................................... 13 I DB3502/T 049.1—2019 前 言 DB3502/T 049—2019《公共安全管理平台信息资源交换规范》分为3个部分： ——第 1 部分：接口服务； ——第 2 部分：数据文件交换； ——第 3 部分：业务协同对接。 本部分为DB3502/T 049—2019的第1部分。 本部分按照GB/T 1.1—2009给出的规则起草。 本部分由厦门市城市公共安全管理领导小组办公室提出并归口。 本部分起草单位：厦门市城市公共安全管理领导小组办公室、厦门市信息中心、厦门市公安局、厦 门市美亚柏科信息股份有限公司、厦门畅博思信息技术有限公司、厦门市标准化研究院。 本部分主要起草人：张若峰、柯国鸿、陈志飞、刘一鸣、龚浩杰、陈锦荣、连志阳、洪亚杰、林大 滨、李童、陈成威、林立南、黄智强。 II DB3502/T 049.1—2019 公共安全管理平台信息资源交换规范 第 1 部分：接口服务 1 范围 DB3502/T 049—2019的本部分规定了公共安全管理平台信息汇聚和共享中数据交换及访问服务接 口的基本框架和接口定义。 DB3502/T 049—2019的本部分适用于采用接口方式、日均交换数据量10万条以下、响应实时性要求 较高的公共安全管理信息数据报送、备案和数据访问业务，以及和公共安全管理平台与部门应用系统间 的业务协同对接。部门应用系统向公共安全管理平台开放数据访问接口服务也可以参照本规范开发。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 25647 电子政务术语 DB3502/Z 033.3—2016 政务信息共享协同平台技术规范 第3部分：平台接入规范 DB3502/T 048.1—2019 公共安全管理平台数据规范 第1部分：信息资源分类 DB3502/T 048.2—2019 公共安全管理平台数据规范 第2部分：数据元 3 术语和定义 GB/T 25647和DB3502/T 048.2—2019界定的以及下列术语和定义适用于本文件。 3.1 接口 interface 体现一个实体行为特征的具有名称的操作集。 3.2 请求 request 接口服务请求方向服务提供方发出一次调用。 3.3 响应 response 接口服务提供方返回给服务请求方的操作结果。 4 缩略语 下列缩略语适用于本文件。 GET：一种从指定的资源请求数据的HTTP方法 HTTP：超文本传输协议（Hyper Text Transfer Protocol） HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over Secure Socket Layer） 1 DB3502/T 049.1—2019 JSON：基于JavaScript语言形式的数据对象表达方式（JavaScript Object Notation） POST：一种向指定的资源提交数据处理请求的HTTP方法 5 基本框架 5.1 接口服务许可、授权和使用 公共安全管理信息数据交换及访问服务接口许可、授权、使用的基本流程如下： a) 接口服务请求方向接口服务提供方提出使用接口服务申请，提交以下信息： ——部门名称； ——部门编码； ——应用场景描述； ——交换/访问服务的信息类别； ——每天最大访问量； ——使用期限，接口授权起止时间； ——最多 8 个许可调用服务的请求方 IP 地址； b) 接口服务审批通过后，接口服务提供方生成访问许可信息，发放给接口服务请求方； c) 接口服务请求方在调用接口服务时，应提供有效的许可信息； d) 接口服务提供方接收到请求后应校验许可信息有效性和合法性，校验通过后，执行服务请求， 向服务请求方返回服务响应内容。 注：通过政务信息共享协同平台使用公共安全管理信息进行数据交换及访问服务，应遵循 DB3502/Z 033.3—2016 第 6 章的请求接入标准流程规定。 5.2 接口服务模型 公共安全管理信息数据访问服务接口遵循DB3502/Z 033.3—2016 第7章相关规范，以HTTP/HTTPS 的方式提供，服务请求方通过POST/GET方式进行数据请求，服务提供方通过同步响应的方式返回响应数 据。接口逻辑架构主要由接口请求参数、接口服务、接口响应数据三部分组成，接口逻辑架构见图1。 图1 接口逻辑架构图 6 接口定义 6.1 接口说明 公共安全管理信息数据访问服务接口地址，应对服务发布路径和服务名称进行约定。如示例1所示。 2 DB3502/T 049.1—2019 示例1： http://XXX.XXX.XXX/SERVICE_PATH/SERVICE_NAME 其中： ——XXX.XXX.XXX：表示服务接口的服务器地址，其取值应为有效的服务器域名或 IP 地址； ——SERVICE_PATH：表示开放接口服务的发布路径，路径层次不做具体要求； ——SERVICE_NAME：表示开放接口服务的名称，由服务提供方命名。 6.2 基本约定 6.2.1 传输协议和消息封装格式 传输协议和消息封装格式为： a)采用HTTP/HTTPS作为传输协议； b)采用JSON作为消息的封装格式。 6.2.2 安全性 在公共安全管理信息数据交换及访问服务接口开发中，采用HTTP SERVICE进行数据传输，服务端进 行用户和许可信息验证。 申请服务的用户应首先向服务提供方提出申请，经审批通过后，获取相应服务的访问许可证。 6.2.3 数据格式 服务接口请求参数和返回结果采用JSON标准格式，请求参数由许可信息参数信息、报送数据参数信 息/数据访问服务条件参数信息组成，返回结果由结果描述信息和结果数据信息组成。 请求参数格式见图2。 许可信息参数信息 报送数据参数信息/数据访问服务条件参数信息 图2 请求参数格式 返回结果内容格式见图3。 结果描述信息 结果数据信息 图3 返回结果格式 数据格式的主要说明如下： a） 许可信息参数的内容符合 6.3 的规定； b） 报送数据参数的内容符合 6.4 的规定； c） 数据访问服务条件参数的内容符合 6.5 的规定； d） 报送结果的内容符合 6.6 的规定； e） 数据返回结果的内容符合 6.7 的规定。 6.3 许可信息参数 6.3.1 许可信息格式 许可信息参数由接口标识符、接口许可证、服务请求业务流水号、服务请求时间四部分组成。如图 4所示。 3 DB3502/T 049.1—2019 接口标识符 接口许可证 服务请求业务流水号 服务请求时间 图4 许可信息参数格式 6.3.2 许可信息格式说明 许可信息标记及含义见表1。 表1 许可信息标记及含义 序号 标记 含义 说明 1 SERVICEID 接口标识符 必填项，由服务提供方提供的 4 位字符的接口标识符 2 TOKEN 接口许可证 必填项，由算法生成的二进制长度为 128 位的数字标 识符 3 REQUESTID 服务请求业务流 水号 必填项，采用 DB3502/T 048.3—2019 《公共安全管理 平台数据规范 第 3 部分： 信息代码》 的 3.1 条“业 务流水号编码规则” 4 REQUESTTIME 服务请求时间 必填项，格式：yyyy-MM-ddHH:mm:ss 许可信息在键值对 HEADERS 中，如示例 2 所示。 示例2： { "HEADERS": { "SERVICEID": "X001", "TOKEN": "b59cb246111347858a7215ff4111729c", "REQUESTID": "51100000MJ0000632D01_1_20181010120000_00001", "REQUESTTIME": "2018-10-10 12:00:00" }, …… } 6.4 报送数据参数 6.4.1 报送数据参数信息格式 报送数据参数由许可信息、数据包描述信息（报送数据信息资源分类代码、报送数据单位编码、报 送数据记录数）和报送数据集三部分组成，其中报送数据集部分由n条数据记录组成，每条数据记录由n 个数据项组成。报送数据参数见图5。 4 DB3502/T 049.1—2019 图5 报送数据参数格式 6.4.2 报送数