【GA公共安全标准】 治安管理信息数据备案及访问服务接口总体技术规范

ICS35.020
中华人民共和国公共安全行业标准GA/T1226-2015
治安管理信息数据备案及访问
服务接口总体技术规范
General ternical specifieations for irterfacas of public securityrdniniszration infornation data finns and atcess seryic2015-03-05 发布
中华人民共和国公安部
2015-03-05实施
本标推按照（GB/T1.1·-2009给出的规测起草。本标准由公安部治安管理局提出。本标推出公安部计算机与信息处理标准化技术委员会归口。GA/I 1226—2015
本标准负责起草单位：公安部治安管理局、渐江省公安厅治安总队、福建省公安厅治安总队、东省公安厅治安局，北京航天金盾科技有限公司、东软集团股份有限公司、长春鸿达信息科技股份有限公司、福建创信息科技有限公司，
本标准主要超草人：唐玉建、李银波、周海帆、陈海滨、王立群、方孵、张晖、李冰、刘杰，1范围
治安管理信息数据备案及访问
服务接口总体技术规范
本标规定了治安管理信息数据备案及访问服务接口的基本框渠和接口定义。本标雅道用于以接口好武进行的治安管现信息数据报送、备案和数据访问，2规范性恶用文件
GA/T 1226—2015
下刻文件对丁本文件的应用是必不可少的，凡是注月期的引用文件，仅往目期的版本适用于本文。风是小性后期的引后文件,其最新版本(包括所有的修改版)适用于本文件。GE 2312信息交换用汉宇编码字符集基本集亿行信息技术中通用多八位靠码字符集（UCS)全国公安桃关机构代码编制规赠C4.5:3所有部分）公安数据元
C4.T200C.2公安信息代码第2部分：治安替理信息分类编码规则①一2.3公安信息代萨竟3部分：抢安管理信息数据归属草应编妈规则CC4公安信息代两第4部分：治安管理信息交换备案数据包编号3调、定里动精将落
3. ！求语和定义
下术证和定义造用于本文件，
核二in:rtas2
恶一个实体行为特征的有名称的薬作集。3..2
请求request
接口服务请求方间服务提供方发出一次调用。3.1.3
响 respamse
接口报务供方返回给服务请求方的操作结果。3.2缩语
下列缩略语适用于本文件，
超文本传输协议
(HypertextTransler Protocol)简单对象访问协议
(Simple Objert Acecss Protocol)Web 服务描述语言
(Weh Scrvice Description Language)可扩展置标语言
(ExtensibleMarkupLanguage)
GA/T 1226—2015
4基本框架
4,接口服务许可、接权和使用
治安管理信息数据备案及访问服务接口许可、授权、使用的基本流程如下：接口服务请求方向接口服务提供方提出使用接口服务申请，提交以下信息：a)
机构代码；
机构名称；
备案/访问服务的信息类别：
使用期限；
-最多16个许可调用服务的请求方IP地址；b）接口服务审批通过后，接口服务提供方生成许可证文件，发放给接口服务请求方；接口服务请求方在调用接口服务时,应提供有效的许可信息；c
接口服务提供方接收到请求后应校验许可证有效性，核验账号ID和口令的合法性，校验通过后，执行服务请求，返回服务响应内容。4.2接口服务模型
治安管现信息数据备案/访问服务接口服务模型如图1所示，接
图1治安管理信息数据备案/访问服务接口服务模型5接口定义
5.1接口说明
治安管理信息备案及数据访问服务接口格式如表1所示。2
接门方法
表1治安管理信息备案及数据访问服务接口格式说明
Siring interface_functianName(String licenre.String infarmarion)
5.2 基本约定
5.2.1传输协设和消息封装格式
传输协议和消息封装格式为：
GA/T 1226—2015
I．interface_lunctioriNatne为约定的服务接口名称，由接口提供方命名2.接口参数和返回值采用XMI.标准格式,见 5,2.43.icense为许而证参数，包体规格见5.34.informatian 为备案数据参数(包体规格见5,4)或数据访间服务条件参数（见5.5）
5。接11返回值返回内容为备案结果（见5.6)或数据访问结果（见5.7）a）采用HTTP或HTTPS作为传输协议；b）采用SOAD作为消息的封装协议，5.2.2命名空间
治安管理信息备案及数据访可服务接历的命名空间卡应对服务发布路径和服务名称迹行药定。郊示所示。
示例1:
(wsdi,delinitians targe! Namesprce=\httes://XXX.Xx.XxK/servicas_pnth/ServiceName\xmlns: tns=\ht2s.//XXK.XXK.XXX/aerrices_Path/ServiceNane\)(/wsdl:definitions)
其中：
XXX.XXX.XXX表示并放接T服务的名称空问，其取值应为有效的服务需域名或IP地止：servica_Path 表示服务发布辟降.由接几服务提供方命名,路径层次不做具体要求；ServiceVame表示约定范股务名称：由服务提供厅命名。一个其体的 WSIL示例如示例 2所示示例2：
(wsdl :definitions ta:getNamespace-\https://xxx.xxx.xxc.xrx/mpspims/populatiunService\xmlns: tns=\httpst//xxxxx xxx.xxx/mpspim/populationService\xmlns:wsdlsoap=\http://schemas.xmlsoap.org/wsdl/soap/\xmlns:soap12=\http://w3.org/2003/05/soap-envelape\xmlns: xsd=\ittp://w3.org/2001/XML.Schema\xmlns;soapenel1-.\htz2.//schemas.xmlsuap.urg/soap/encoding/xmlns: s0apencl2=\hltp://w3.org/2003/05/soa[-tncoding\xmlns:suapli=\http://sehemas.xmlsoap.org/soap/cnvelone/\xmfns; wsdl=\http://schemas.xmlsoap.org/wsdl/\>(/wsdl.definitians
GA/T1226—2015
5.2.3安全性
在治安管理信息数据备案及访问服务接口开发中，按照WS-Security 规范来实现用广的认证、授权和传输加密。
申请服务的用广应首先向服务提供方提出申请，经审批通过后，获取相应服务的访问许可证。5.2.4数据格式
接口参数和返回值来用XML标准格式，由声明和包体两部分组成，如图2所示。声明
图 2 接口参数和返回值格式
声明部分符合 XML 1.0规范，采用GB13000的 UTF-8编码，使用XML语言表述如下：(?xmlversion-\1.o\encoding-\UTF-8\?)包体部分规格符合以下要求：
a）诈可证参数的包体符合5.3的规定：b）备案数据参数的包体符合5.4的规定；数据访闻服务条件参数的包体符合5.5的规定；e
备案结果的包体符合5.6的规定；c)
数据访间结果的包体符合5.7的规定。许可证参数
包体格式
许可证包体部分由用户信息、授权信息和验证信息三部分组成：如图3所示用户信息
5.3.2许可证内标记及含义
许可证内标记及含义如表2所示。授权信息
图3许可证包体格式
验证信息
信息类别
用户信息
授权信息
验证信息
ORG_CODE
ORG_NAME
ACCOUNT D
PASSWORD
BEGIN_DATE
END_DATE
SERVICE_CODE
SERVICE.VAME
: SIGNATURE
许可证参数格式说膜
表2许可证内标记及含义
长度(字符)
公安机关机商代码
公安机关机酶名称
账号m
授皮许可的能证
许可派纯月劳装
并始讨写
许可连用的装
给末司
信惠热剂
信息含条
诈更压险更信息
GA/T 1226—2015
求服务的单位代码，符合 GA/T 380的规定
境求服务的单应名称
应采用接门服务提供方系统中注册的用户
Shal哈希算法的口令加密数据
标记内可设定一个或多个有效 IPv4地理+多址时拟半短号分扇
YYYYMMDDhhmms
YYYYMMDhhmm&s
符合GA/T2000.2的规定
. 符会 C.1,T 20C0.2 的规定
Shal 吟考等法能 tieene 指软信息，措效言息内包含机考代码、账零、IP逆证,许可还适比对亚,数务标识信意包体部分的所有内容放置在标记LICEN2一..”/LICENSE之间。起厚栏为服务5.3.3.1
提识方分配给服务请求方的 license唑~标识,用产信息放置在标记5.3.3.3服务授权信息放置在标记、EEEVTCEINFO)之间。一个许可证中可包括多个服务授权信息、每个服务授权信息放置在标记、空EICE)/SERVICE)之间。5.3.3.4验证信息放置在标记示例：
(USERINFO)
(ORG_CODE)-{/ORG_CODE>
(ORG_NAME) -(ACCOUNT_ID>-.-(/ACCOUNT_(D)(PASSWORD)--(/PASSWORD)
(P)-(/IP)
(BEGIN_DATE>..{(/BEGIN_DATE)(END_DATE)--{/END_DATE)
(/USERINFO)
(SERVICEINFO)

GA/T 1226—2015
(SERVICE_CODE>-----{/SERVICE_NAME)
---(/SERVICE>
(/SERVTCEINFO)
(SIGNATURE) ---(/SIGNATURE)
(/LICENSE
5.4备案数据参数
5.4.1包体格式
备案数据包体部分由数据包描述和多条数据记录组成，每条数据记录由多个数据项组成。如图4所东。
数据包描述
5.4.2备案数据包体格式说明
数据记录1
激据记采！
数据项上数据项n
图4备案数据包体格式
5.4.2.1包体部分的所有内容放置在标记(PACKAGE)-(/PACKAGE>之间。5.4.2.2数据包描述中的所有内容放置在标记之间。数据包描述内容包括版本号、单位代码、单位名称、记录数、发送时间、数据包编号，规格要求如表3所示。表3备案数据参数数据包描述
顺序号
长度(字符)
版本号
单位代码
单位名称
备案记录数
发送时间
数据包编号
暂定为3,00。1.00表示以GB2312编码方式传输的居民身份证制作信息。 2. 00 表示以GB13000编码方式交换的居民身份正制证信息和人口管理信息
数据归属单惊代码，符合GA/T2000.3的规定数据归属单位的名称
由不超过4位数字字符组成。当单条备案数据长度超过 10 kB时备案记录数应不超过 100YYYYMMDDhhmmss
采用GA/T2000.4的规定
所有的备案的业务数据放置在标记5.4.2.4每一条备案数据记录放置在标记5.4.2.5每一个备案数据项内容放置在该数据项的标记之间.若数据项内容为空时，数据项标记不应省略，各数据项标记应符合相关治安管理备案接口或数据项规范中数据项标识符的规定，数据项标记采用全部大写的方式表示。
备案数据包格式如示例所示，
示例：
(?xml veryion-\1.0\encoding=\(UTF 8\?)(DWDM)..-
(ILS>999(/JL5>
(FSSJ)20110112110221
(SIBBH...../SIBIH)
(/PACKAGEHEAD)
(DATA)
(RECORI)no-_\1\sid=\010202\)(GMSFHM)...(/RECORD)
.../XM)
...
K/RECORD
(/DAIA)
(/PACKAGE)
5.5数据访问服务条件参数
5.5.1包体格式
条件参数包体部分由多个条件数据记录纽成，每个条件数据记录由多个条件数据项纽成，如图5所示。
条件数据记录！
条件数据记录
条件数镀项1·条件效据项Ⅱ
图5条件参数包体格式
GA/T 1226—2015
5.5.2条件参数包体格式说明
5.5.2.1所有条件数据记录放置在标记(CONDITIONS)之间5.5.2.2
CONDITION标记的no属性为条件数据记录的序号，其取值为从1开始的顺序号。5.5.2.3
CONDITION标记的sid属性为授权信息的分类代码，符合相关治安管理信息分类编码标准5.5.2.4
的规定，
5.5.2.5CONDITION标记的exP属性指定查询条件数据项的逻辑关系，其中逻辑*与\用”*\号表示、逻辑“或”用“十”号表示，括号标识优先等级，条件数据项按照顺序用1、2、3、、五的连续数字表示，本属性省略或取值为空时，默认条件关系为逻辑“与”。5.5.2.6CONDITION标记的Iesult属性措定查询结果返回的数据项，各数据项间半角逗号\，\分隔，查询结果数据项标记符合相关治安管理信息数据项规范中数据项标识符的规定，数据项标记采用全部大写的方式表示。
5.5.2.7每一个条件数据在该数据项的标记之间，各数据项标记应衍合相关洽安管理数据请求服务接口规范中条件信息数据项标识符的规定，数据项标记采用全部大写的方式表示。5.5.2.8条件数据项标记录中的operation属性指定关系运算符，其表示及含义如表4所示：表4关系运算符表示及含义
关系运算伴
>(>)
<-(<-)
(&rgt: -)
Left Hke
rignt like
isnull
is not null
格式如示例所示，
示例：
小于或等于
大于或等于
不等于
模糊匹配
左匹配
右匹配
按照对应效据,元的数据类型：
1、字管墅按字符编码顺序进行比载数危型：应转换成数值选行比较2.
日期型：应转换成日期选行比被3.
日期时可型：应转换成时可进行比段
1、仅可应用于字符型的数据项
2．从字符串任意位曾进行匹配
1．仅可应用于字符类型的数据项2．从字符串起始端匹配
1.仅可应用于字符类型的数据项2、从字符串结尾端进行匹配
(CONDITION no-\1\sid-\QI0202\exp-\1 * 2\result-\XM,XBDM,GMSFHM\)张三
GA/T 1226—2015
张三《/XM)(XM operation=\=\>李四(/XM>(XRIM oPeration=\=\>2(/XBDM>/CONDITION)
(/CONDITIONS)
5.6备案结果
5.6.1包体格式
备案返回结果部分由数据包描述和多条备案结果记录组成：备案失败或全部数据备案成功时只返回数据包描述，当备案数据部分发生异常时，返回每条异常数据的备案结果。如图6所示。激据包描述
数据记录1
数据记录n
数据项1 -数据项n
图6备案返回结果数据包体格式
5.6.2备案返回结果数据包格式说明5.6.2.1包体部分的所有内容放置在标记(PACKAGE>-返回数据包捐述中的所有内容放置在标记顺序孕
长度(字符）
版本号
单位代码
单位名称
记录数
发送时间
数据包编号
返回代码
返回描述
暂定为3.00。1.00表示以GB2312编码方式传输的居民身份证制作信息。2.00表示部级人口信息管理系统数据交换格式数据归属单位代码
数据归属单位的名称
备案成功人库记录数
备案数据入库时间
年月月时分秒：
YYYYMMUEhhmmss
采用 GA/T 2000.4规定的编码方法备案数据返回代码
备案数据返回描述
发生备案数据处理异常时,返回异常数据的结果信息，所有的结果信息置于bzxz.net
GA/T 1226—20 15
标记之间。每一条结果信息由一段《RECORD).《/RECORD)标记表示。5.6.2.4《RECORD>标记的no属性为接收备案数据中的数据序号。属性sid为接收备案数据的信息分类代码，属性code为返回的异常代码，属性msg为返同的异常描述。返回代码取值及含义见第6章。备案返回结果格式如示例所示。示例：
(?xml version-\1.0\encoding=\UTF-8\?)
(PACKAGEHEAD>
<(BBH)3.00(DWDM) .*.-(/DWDM)
(DWMC)--..--(/DWMC)
(JLS>99(/JLS)
(FSSJ)20110I12110221(/FSSJ)
(SIBTH>...--
(MSG).--(/MSG?
(/FACKAGEHEAD)

(FECORDno-2\sid-\o10202\aoce-\>(/PACKAGE>
数据访问结果
5.7.1包体格式
返回结果信息的包休部分由多组条件数据记录和套询端案数落记录组成，其中每组记录由一个条件数据记录和多条查询结果数据记录组成·条件数据记录与查结累数据记录又出多个数据项组成。接口服务调用失败时只返回包体标记和错误代码、错描述信息，数据访问服务异常时，在其返回结果记录中标识错误代码和错误描述信息。返回结果数据包体格式如图7所示。查询结果1
查润条作数据
效据项1~数据项n
查谕结果2
采数据记录1
数据项1-数据项r
查淘盐果激施
图7返回结果数据包体格式
查河绘果n
缔果黎据记录
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。