DB3502/T 049.1-2019 公共安全管理平台信息资源交换规范 第1部分：接口服务

DB3502/T

福建省厦门市地方标准

DB3502/T049.1—2019

公共安全管理平台信息资源交换规范

第1部分：接口服务

Specificationofinformationresourceexchangeforpublicsecuritymanagement

platform—Part1:Interfaceservices

2019-09-10发布2019-10-01实施

厦门市市场监督管理局发布

DB3502/T049.1—2019

目次

前言................................................................................II

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4缩略语............................................................................1

5基本框架..........................................................................2

6接口定义..........................................................................2

7交换数据项值域...................................................................13

I

DB3502/T049.1—2019

前言

DB3502/T049—2019《公共安全管理平台信息资源交换规范》分为3个部分：

——第1部分：接口服务；

——第2部分：数据文件交换；

——第3部分：业务协同对接。

本部分为DB3502/T049—2019的第1部分。

本部分按照GB/T1.1—2009给出的规则起草。

本部分由厦门市城市公共安全管理领导小组办公室提出并归口。

本部分起草单位：厦门市城市公共安全管理领导小组办公室、厦门市信息中心、厦门市公安局、厦

门市美亚柏科信息股份有限公司、厦门畅博思信息技术有限公司、厦门市标准化研究院。

本部分主要起草人：张若峰、柯国鸿、陈志飞、刘一鸣、龚浩杰、陈锦荣、连志阳、洪亚杰、林大

滨、李童、陈成威、林立南、黄智强。

II

DB3502/T049.1—2019

公共安全管理平台信息资源交换规范

第1部分：接口服务

1范围

DB3502/T049—2019的本部分规定了公共安全管理平台信息汇聚和共享中数据交换及访问服务接

口的基本框架和接口定义。

DB3502/T049—2019的本部分适用于采用接口方式、日均交换数据量10万条以下、响应实时性要求

较高的公共安全管理信息数据报送、备案和数据访问业务，以及和公共安全管理平台与部门应用系统间

的业务协同对接。部门应用系统向公共安全管理平台开放数据访问接口服务也可以参照本规范开发。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T25647电子政务术语

DB3502/Z033.3—2016政务信息共享协同平台技术规范第3部分：平台接入规范

DB3502/T048.1—2019公共安全管理平台数据规范第1部分：信息资源分类

DB3502/T048.2—2019公共安全管理平台数据规范第2部分：数据元

3术语和定义

GB/T25647和DB3502/T048.2—2019界定的以及下列术语和定义适用于本文件。

3.1

接口interface

体现一个实体行为特征的具有名称的操作集。

3.2

请求request

接口服务请求方向服务提供方发出一次调用。

3.3

响应response

接口服务提供方返回给服务请求方的操作结果。

4缩略语

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

GET：一种从指定的资源请求数据的HTTP方法

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

HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）

1

DB3502/T049.1—2019

JSON：基于JavaScript语言形式的数据对象表达方式（JavaScriptObjectNotation）

POST：一种向指定的资源提交数据处理请求的HTTP方法

5基本框架

5.1接口服务许可、授权和使用

公共安全管理信息数据交换及访问服务接口许可、授权、使用的基本流程如下：

a)接口服务请求方向接口服务提供方提出使用接口服务申请，提交以下信息：

——部门名称；

——部门编码；

——应用场景描述；

——交换/访问服务的信息类别；

——每天最大访问量；

——使用期限，接口授权起止时间；

——最多8个许可调用服务的请求方IP地址；

b)接口服务审批通过后，接口服务提供方生成访问许可信息，发放给接口服务请求方；

c)接口服务请求方在调用接口服务时，应提供有效的许可信息；

d)接口服务提供方接收到请求后应校验许可信息有效性和合法性，校验通过后，执行服务请求，

向服务请求方返回服务响应内容。

注：通过政务信息共享协同平台使用公共安全管理信息进行数据交换及访问服务，应遵循DB3502/Z033.3—2016第

6章的请求接入标准流程规定。

5.2接口服务模型

公共安全管理信息数据访问服务接口遵循DB3502/Z033.3—2016第7章相关规范，以HTTP/HTTPS

的方式提供，服务请求方通过POST/GET方式进行数据请求，服务提供方通过同步响应的方式返回响应数

据。接口逻辑架构主要由接口请求参数、接口服务、接口响应数据三部分组成，接口逻辑架构见图1。

图1接口逻辑架构图

6接口定义

6.1接口说明

公共安全管理信息数据访问服务接口地址，应对服务发布路径和服务名称进行约定。如示例1所示。

2

DB3502/T049.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安全性

在公共安全管理信息数据交换及访问服务接口开发中，采用HTTPSERVICE进行数据传输，服务端进

行用户和许可信息验证。

申请服务的用户应首先向服务提供方提出申请，经审批通过后，获取相应服务的访问许可证。

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/T049.1—2019

接口标识符接口许可证服务请求业务流水号服务请求时间

图4许可信息参数格式

6.3.2许可信息格式说明

许可信息标记及含义见表1。

表1许可信息标记及含义

序号标记含义说明

1SERVICEID接口标识符必填项，由服务提供方