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

1、I. ICS 35.020 A 90 G 中华人民共和国公共安全行业标准GA/T 1226-2015 治安管理信息数据备案及访问服务接口总体技术规范General technical specifications for interfaces of public security administration information data filing and access service 2015-03-05发布2015-03-05实施.i码.，攻川，lr一气、飞3飞，心：.吨踪监：.，.al治,l;jfr且伪中华人民共和国公安部发布 , . 前本标准按照GB/T1.1-2009给出的规

2、则起草。本标准由公安部治安管理局提出。本标准由公安部计算机与信息处理标准化技术委员会归口。GA/T 1226-2015 本标准负责起草单位z公安部治安管理局、浙江省公安厅治安总队、福建省公安厅治安总队、广东省公安厅治安局、北京航天金盾科技有限公司、东软集团股份有限公司、长春鸿达信息科技股份有限公司、福建天创信息科技有限公司。本标准主要起草人z唐玉建、李银波、周海帆、陈海滨、玉立群、方鹏、张晖、李冰、刘杰。I GA/T 1226-2015 1 范围治安管理信息数据备案及访问服务接口总体技术规范本标准规定了治安管理信息数据备案及访问服务接口的基本框架和接口定义。本标准适用于以接口方式进行的治安管理

3、信息数据报送、备案和数据访问。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改版）适用于本文件。GB 2312 信息交换用汉字编码字符集基本集GB 13000 信息技术中通用多八位编码字符集（UCS)GA/T 380 全国公安机关机构代码编制规则GA/T 543（所有部分）公安数据元GAIT 2000.2公安信息代码第2部分：治安管理信息分类编码规则GAIT 2000.3公安信息代码第3部分z治安管理信息数据归属单位编码规则GAIT 2000.4公安信息代码第4部分z治安管理信息交换备案

4、数据包编号3 术语、定义和缩畸语3.1 术语和定义下列术语和定义适用于本文件。3. 1. 1 接口interface 体现一个实体行为特征的具有名称的操作集。3.1.2 请求叫时接口服务请求方向服务提供方发出一次调用。3.1.3 晌应r四ponse接口服务提供方返回给服务请求方的操作结果。3.2 缩略语下列缩略语适用于本文件。HTTP 超文本传输协议(Hypertext Transfer Protocol) SOAP 简单对象访问协议(Simple Object Access Protocol) WSDL Web服务描述语言(Web Service Description Language)

5、XML 可扩展置标语言(Extensible Markup Language) 1 GA/T 1226-2015 4 基本框架4.1 接口服务许可、授权和使用治安管理信息数据备案及访问服务接口许可、授权、使用的基本流程如下za) 接口服务请求方向接口服务提供方提出使用接口服务申请，提交以下信息机构代码p一一机构名称p一一备案访问服务的信息类别s一一使用期限；一一最多16个许可调用服务的请求方IP地址Fb) 接口服务审批通过后，接口服务提供方生成许可证文件，发放给接口服务请求方；c) 接口服务请求方在调用接口服务时，应提供有效的许可信息；d) 接口服务提供方接收到请求后应校验许可证有效性，核验账

6、号ID和口令的合法性，校验通过后，执行服务请求，返回服务响应内容。4.2 接口服务模型治安管理信息数据备案访问服务接口服务模型如图1所示。( 卢 接接口请求口服服务务提请f、供求响应7i 方 .) 圄1治安管理信息数据备案访问服务接口服务模型5 接口定义5.1 接口说明治安管理信息备案及数据访问服务接口格式如表1所示。2 GA/T 1226-2015 表1治安管理信息备案及鼓据访问服务接口格式接口方法说明a由iginterface_ functionName ( S国nglicense, 1. int町facefunctionName为约定的服务接口名称，由接口提供方命名String info

7、rmation) 2. 接口参数和返回值采用XML标准格式，见5.2.43. license为许可证参数，包体规格见5.34. information为备案数据参数（包体规格见5.4）或数据访问服务条件参数见5.5)5. 接口返回值返回内容为备案结果（见5.的或数据访问结果见5.7)5.2 基本约定5.2.1 传输协议和消息封装格式传输协议和消息封装格式为2a) 采用HTTP或HTTPS作为传输协议zb) 采用SOAP作为消息的封装协议。5.2.2命名空间在治安管理信息备案及数据访问服务接口的命名空间中应对服务发布路径和服务名称进行约定。如示例1所示。示例1: wsdl: definition

8、s targetNamespace=”https: I /XXX.XXX.XXX/ services_path/ServiceName” xmlns:tns=”https: / /XX:X.XXX.XXX/ services_path/ServiceName” ( SERVICEINFO 5 GA/T 1226-2015 (SERVICE_ CODE)(/SERVICE_ CODE (/SERVICE_NAME 5.4 备案数据参数5.4.1 包体格式备案数据包体部分由数据包描述和多条数据记录组成，每条数据记录由多个数据项组成。如图4所示。数据包描述数据记录1数据记录n数据项1数据项n圄4备案

9、数据包体格式5.4.2 备案数据包体格式说明5.4.2.1 包体部分的所有内容放置在标记PACKAGE）！PACKAGE之间。5.4.2.2数据包描述中的所有内容放置在标记PACKAGEHEAD（/PACKAGEHEAD）之间。数据包描述内容包括版本号、单位代码、单位名称、记录数、发送时间、数据包编号，规格要求如表3所示。表3备案鼓据参鼓鼓据包描述顺序号标记长度（字符含义说明暂定为3.000 1.00表7.K以GB2312编码方式版本号传输的居民身份证制作信息。2.00表示以1 BBH 4 GB 13000编码方式交换的居民身份证制证信息和人口管理信息2 DWDM 12 单位代码数据归属单位代

10、码，符合GA/T2000.3的规定3 DWMC 100 单位名称数据归属单位的名称JLS 4 备案记录数由不超过4位数字字符组成，当单条备案数据4 长度超过10kB时备案记录数应不超过1005 FSSJ 14 发送时间YYYYMMDDhhmmss 6 SJBBH 25 数据包编号采用GAIT2000.4的规定5.4.2.3 所有的备案的业务数据放置在标记DATA）（DATA之间。. GA/T 1226-2015 5.4.2.4 每一条备案数据记录放置在标记RECORDno”n飞id”RECORD）之间。属性no为数据的序号，其取值n为从1开始的顺序号，n的最大值为PACKAGEHEAD标记内J

11、LS的表示值。属性sid为备案信息的信息分类代码。备案数据记录包含的数据项应符合相关治安管理信息交换数据项标准的规定。5.4.2.5 每一个备案数据项内容放置在该数据项的标记之间，若数据项内容为空时，数据项标记不应省略，各数据项标记应符合相关治安管理备案接口；或数据项规范中数据项标识符的规定，数据项标记采用全部大写的方式表示。备案数据包格式如示例所示。示例z( ?xml version”1.。”encoding”UTF-8”？(PACKAGE (PACKAGEHEAD 3.00(/BBH (/DWMC (JLS999(/JLS (/SJBBH (/PACKAGEHEAD ( GMSFHM .

12、(/GMSFHM (/RECORD (RECORD no=”2”sid=”010104”. (/XM (/RECORD (/DATA (/PACKAGE 5.5 数据访问服务条件参数5.5.1 包体格式条件参数包体部分由多个条件数据记录组成，每个条件数据记录由多个条件数据项组成。如图5所示。条件数据记录1条件数据记录n条件数据项1条件数据项n固5条件参数包体格式7 GA/T 1226-2015 5.5.2 条件参数包体格式说明5.5.2.1 所有条件数据记录放置在标记CONDITIONS）（CONDITIONS之间。5.5.2.2 每个条件数据记录放置在标记CONDITION）（CONDITI

13、ON之间。5.5.2.3 CONDITION标记的no属性为条件数据记录的序号，其取值为从1开始的顺序号。5.5.2.4 CONDITION标记的sid属性为授权信息的分类代码，符合相关治安管理信息分类编码标准的规定。5.5.2.5 CONDITION标记的exp属性指定查询条件数据项的逻辑关系，其中逻辑“与”用“赞”号表示、逻辑“或”用“”号表示，括号标识优先等级，条件数据项按照顺序用1,2,3,n的连续数字表示，本属性省略或取值为空时，默认条件关系为逻辑“与”。5.5.2.6 CONDITION标记的result属性指定查询结果返回的数据项，各数据项间以半角逗号“，”分隔，查询结果数据项标

14、记符合相关治安管理信息数据项规范中数据项标识符的规定，数据项标记采用全部大写的方式表示。5.5.2.7 每一个条件数据在该数据项的标记之间，各数据项标记应符合相关治安管理数据请求服务接口规范中条件信息数据项标识符的规定，数据项标记采用全部大写的方式表示。5.5.2.8 条件数据项标记录中的operation属性指定关系运算符，其表示及含义如表4所示。表4关系运算符表示及含义关系运算符(&.gt;) = 说明按照对应数据元的数据类型z1. 字符型z按字符编码顺序进行比较2. 数值型z应转换成数值进行比较3. 日期型z应转换成日期进行比较4. 日期时间型z应转换成时间进行比较1. 仅可应用于字符型

15、的数据项2. 从字符串任意位置进行匹配1. 仅可应用于字符类型的数据项2. 从字符串起始端匹配1. 仅可应用于字符类型的数据项2. 从字符串结尾端进行匹配8 (XBDM operation=”=”)1(/XBDM (/CONDITIONS 5.6 备案结果5.6.1 包体格式备案返回结果部分由数据包描述和多条备案结果记录组成。备案失败或全部数据备案成功时只返回数据包描述。当备案数据部分发生异常时，返回每条异常数据的备案结果二如图6所示。数据包描述数据记录1数据记录n数据项1数据项n固6备案返回结果数据包体格式5.6.2 备案返回结果数据包格式说明5.6.2.1 包体部分的所有内容放置在标记PA

16、CKAGEPACKAGE）之间。5.6.2.2 返回数据包描述中的所有内容放置在标记PACKAGEHEADPACKAGEHEAD之间。数据包描述主要包括版本号、记录数、发送时间、返回代码、返回描述，如表5所示。表5备案结果数据包描述 顺序号标记长度字符）含义说明、暂定为3.oo.1. oo表示以GB2312编码方式1 BBH 4 版本号传输的居民身份证制作信息.2.00表示部级人口信息管理系统数据交换格式2 DWDM 12 单位代码数据归属单位代码3 DWMC 100 单位名称数据归属单位的名称4 JLS 4 记录数备案成功入库记录数备案数据入库时间5 FSSJ 14 发送时间年月日时分秒2Y

17、YYYMMDDhhmmss 6 SJBBH 25 数据包编号采用GA/T2000.4规定的编码方法7 CODE 3 返回代码备案数据返回代码8 MSG 500 返回描述备案数据返回描述5.6.2.3 发生备案数据处理异常时，返回异常数据的结果信息，所有的结果信息置于DATA）DATA)GA/T 1226-2015 标记之间。每一条结果信息由一段（RECORD. (/RECORD）标记表示。5.6.2.4 DWDM/DWMC /SJBBH (CODE /CODE (/PACKAGEHEAD 5.7 数据访问结果5.7.1 包体格式返回结果信息的包体部分由多组条件数据记录和查询结果数据记录组成，其

18、中每组记录由一个条件数据记录和多条查询结果数据记录组成，条件数据记录与查询结果数据记录又由多个数据项组成。接口服务调用失败时只返回包体标记和错误代码、错误描述信息。数据访问服务异常时，在其返回结果记录中标识错误代码和错误描述信息。返回结果数据包体格式如图7所示。查海结果1查询结果2查询结果n查询条件锺据查询结果数据数据项1数据项n结果数据记录1结果数据记录n数据项1数据项n圄7返回结果数据包体格式10 GA/T 1226-2015 5.7.2 返回结果信息格式说明5.7.2.1 包体所有返回信息放置在标记（DATAcode”msg”（DATA之间，属性code为返回的结果代码，属性msg为返回

19、的结果描述。5.7.2.2 查询结果返回记录置于RECORD与（RECORD标记之间。5.7.2.3 输入参数中的条件数据记录放置在（CONDITIONno二”n”sid”xxx”exp”xxx”result”xxx,xxx”（CONDITION）之间，其结构及含义如下za) 属性no为输入条件参数的序号zb) 属性sid为输入条件参数中的服务标识，其取值为应用服务分类代码Fc) 属性exp为输人条件参数中查询条件数据项的逻辑关系表达式zd) 属性result为输入条件参数中的查询结果数据项取值。5.7.2.4 查询结果记录放置在RESULTnum ”n”（RESULT）标记之间当同一条件返回

20、多组结果数据时，每组数据用ROW）与（ROW）分隔。其中num属性为匹配的结果记录数，num最大值需要根据接口服务器性能及服务所提供的数据项实际情况决定，默认约定最大值为1000.当没有查询到符合条件的结果记录时，num取值为0。5.7.2.5 每组数据不同记录间用（ROWindex”n勺与（ROW分隔，属性index为从1开始的连续流水号，表示返回结果的顺序号。每个查询结果数据项放置在该数据项的标记之间，各数据项标记应符合相关治安管理数据访问服务接口规范中结果信息数据项标识符的规定，数据项标记采用全部大写的方式表示。5工2.6 .:/XM ( GMSFHM . ( /GMSFHM (/CON

21、DITION) (ROW index=”1”( GMSFHM) . (/GMSFHM . ( /XBDM) (/ROW (ROW index=”2”11 GA/T 1226-2015 /RECORD /DATA 6 返回代码及说明返回代码及说明如表6所示。表6返回代码及说明返回代码说明10 接口词用成功11 备案数据接收成功，但备案数据的“发送时间”早于巳备案数据的最后发送时间12 数据访问服务调用成功，但发生数据服务处理异常20 备案数据部分发生异常30 请求目标地公安机关未开展相关服务一10数据库连接失败-20 接口应用内部错误-30 不是有效的XML文件-31 XML文件不符合规范格式-

22、40 用户不存在-41 用户密码错误-42 E地址受限-43 许可证使用期限过期-50 许可证校验错误一60备案数据版本号错误一61备案数据单位代码错误-62 备案数据单位名称错误-63 备案数据记录数错误-64 备案提交的记录数超过限制一65备案数据发送时间错误-66 数据包编号错误-67 超出服务限制-68 服务不存在12 h GA/T 1226-2015 表6（续返回代码说明-69 授权错误（备案信息未经授权一70信息不符合数据项规范扩展错误描述）-71 信息分类代码错误一72数据项非法73 条件参数逻辑表达式错误74 备案数据重复上报-90 系统异常7 交换数据项值域交换数据项取值符合

23、GAIT543中对应数据元的值域。其实际长度取决于其内容包含的字符在UTF-8字符编码中的表示长度。二进制类型的数据项，应通过Base64编码规则转换为字符串后放置在数据项标记之间。13 EONNNFH司。中华人民共和国公共安全行业标准治安管理信息数据备案及请问服务接口总体技术规范GA/T 1226-2015 ” 中国标准出版社出版发行北京市朝阳区和平里西街甲2号(100029)北京市西城区三里河北街16号(10004日网址.en 总编室：(010)68533533 发行中心沃010)51780238读者服务部，（010)68523946中国标准出版社秦皇岛印刷厂印刷各地新华书店经销* 印张1.25字数30千字2015年5月第一次印刷开本88012301/16 2015年5月第一版铸书号：155066 2-28695定价21. 00元如有印装差错由本社发行中心调换版权专有侵权必究举报电话：(010)68510107 GAIT 1226-2015 打印日期：2015年6月9日F002