GA/T 1226-2015 治安管理信息数据备案及访问服务接口总体技术规范

ICS35.020

A90

中华人民共和国公共安全行业标准

/—

GAT12262015

治安管理信息数据备案及访问

服务接口总体技术规范

ㅤㅤㅤㅤ

Generaltechnicalsecificationsforinterfacesofublicsecurit

ppy

administrationinformationdatafilinandaccessservice

g

2015-03-05发布2015-03-05实施

中华人民共和国公安部发布

/—

GAT12262015

治安管理信息数据备案及访问

服务接口总体技术规范

1范围

本标准规定了治安管理信息数据备案及访问服务接口的基本框架和接口定义。

、。

本标准适用于以接口方式进行的治安管理信息数据报送备案和数据访问

2规范性引用文件

。,

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

。,()。

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

GB2312信息交换用汉字编码字符集基本集

GB13000信息技术中通用多八位编码字符集()

UCS

/全国公安机关机构代码编制规则

GAT380

/()

GAT543所有部分公安数据元

/:

公安信息代码第部分治安管理信息分类编码规则

GAT2000.22

/:

公安信息代码第部分治安管理信息数据归属单位编码规则

GAT2000.33

ㅤㅤㅤㅤ

/:

公安信息代码第部分治安管理信息交换备案数据包编号

GAT2000.44

、

3术语定义和缩略语

3.1术语和定义

下列术语和定义适用于本文件。

3.1.1

接口interface

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

3.1.2

请求reuest

q

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

3.1.3

响应resonse

p

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

3.2缩略语

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

超文本传输协议()

HTTPHertextTransferProtocol

yp

SOAP简单对象访问协议()

SimleObectAccessProtocol

pj

服务描述语言()

WSDLWebWebServiceDescritionLanuae

pgg

可扩展置标语言()

XMLExtensibleMarkuLanuae

pgg

1

/—

GAT12262015

4基本框架

、

4.1接口服务许可授权和使用

、、:

治安管理信息数据备案及访问服务接口许可授权使用的基本流程如下

),:

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

———机构代码;

———机构名称;

———/;

备案访问服务的信息类别

———使用期限;

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

16IP

),,;

b接口服务审批通过后接口服务提供方生成许可证文件发放给接口服务请求方

),;

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

),,

接口服务提供方接收到请求后应校验许可证有效性核验账号和口令的合法性校验通过

dID

,,。

后执行服务请求返回服务响应内容

4.2接口服务模型

/。

治安管理信息数据备案访问服务接口服务模型如图所示

1

ㅤㅤㅤㅤ

/

图治安管理信息数据备案访问服务接口服务模型

1

5接口定义

5.1接口说明

治安管理信息备案及数据访问服务接口格式如表所示。

1

2

/—

GAT12262015

表1治安管理信息备案及数据访问服务接口格式

接口方法说明

,

_

_(,1.interfacefunctionName为约定的服务接口名称由接口提供方命名

StrininterfacefunctionNameStrinlicense

gg

,

Strininformation)2.接口参数和返回值采用XML标准格式见5.2.4

g

,

3.license为许可证参数包体规格见5.3

()

4.information为备案数据参数包体规格见5.4或数据访问服务条

()

件参数见5.5

()()

5.接口返回值返回内容为备案结果见5.6或数据访问结果见5.7

5.2基本约定

5.2.1传输协议和消息封装格式

传输协议和消息封装格式为:

)采用或作为传输协议;

aHTTPHTTPS

)采用作为消息的封装协议。

bSOAP

5.2.2命名空间

在治安管理信息备案及数据访问服务接口的命名空间中应对服务发布路径和服务名称进行约定。

如示例所示。ㅤㅤㅤㅤ

1

示例1:

<::///_/

wsdldefinitionstaretNamesace="httsXXX.XXX.XXXservicesathServiceName"

gppp

::///_/>

xmlnstns="httsXXX.XXX.XXXservicesathServiceName"

pp

……

</:>

wsdldefinitions

其中:

,;

表示开放接口服务的名称空间其取值应为有效的服务器域名或地址

XXX.XXX.XXXIP

_,,体要求;

serviceath表示服务发布路径由接口服务提供方命名路径层次不做具

p

,。

ServiceName表示约定的服务名称由服务提供方命名

一个具体的示例如示例所示。

WSDL2

示例2:

<::////

wsdldefinitionstaretNamesace="httsxxx.xxx.xxx.xxxmsimsoulationService"

gpppppp

::////

xmlnstns="httsxxx.xxx.xxx.xxxmsimsoulationService"

ppppp

:://///

xmlnswsdlsoa="httschemas.xmlsoa.orwsdlsoa"

pppgp

:://///

xmlnssoa12="httwww.w3.or200305soa-enveloe"

ppgpp

::////

xmlnsxsd="httwww.w3.or2001XMLSchema"

pg

:://///

xmlnssoaenc11="httschemas.xmlsoa.orsoaencodin"

pppgpg

:://///

xmlnssoaenc12="httwww.w3.or200305soa-encodin"

ppgpg

:://///

xmlnssoa11="httschemas.xmlsoa.orsoaenveloe"

pppgpp

::////>

xmlnswsdl="httschemas.xmlsoa.orwsdl"

ppg

……

</:>

wsdldefinitions

3

/—

GAT12262015

5.2.3安全性

,、

在治安管理信息数据备案及访问服务接口开发中按照WS-Securit规范来实现用户的认证授权

y

和传输加密。

,,。

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

5.2.4数据格式

,,。

接口参数和返回值采用标准格式由声明和包体两部分组成如图所示

XML2

图接口参数和返回值格式

2

,,:

声明部分符合规范采用的编码使用语言表述如下

XML1.0GB13000UTF-8XML

<?xmlversion="1.0"encodin="UTF-8"?>

g

包体部分规格符合以下要求:

)许可证参数的包体符合的规定;

a5.3

)备案数据参数的包体符合的规定;

b5.4

)数据访问服务条件参数的包体符合的规定;

c5.5

)备案结果的包体符合的规定;ㅤㅤㅤㅤ

d5.6

)数据访问结果的包体符合的规定。

e5.7

5.3许可证参数

5.3.1包体格式

、。。

许可证包体部分由用户信息授权信息和验证信息三部分组成如图所示

3

图3许可证包体格式

5.3.2许可证内标记及含义

许可证内标记及含义如表所示。

2

4

/—

GAT12262015

表2许可证内标记及含义

()

信息类别标记长度字符含义说明

,/