消防公共服务平台技术规范 第2部分：服务管理接口 GA/T1038.2-2012
前言
中华人民共和国公共安全行业标准
消防公共服务平台技术规范
第2部分：服务管理接口
Technical specifications for the public fire service platform—
Part 2: Service management interfaces
GA/T 1038.2—2012
2012-12-27发布 2013-01-01实施
中华人民共和国公安部 发布
GA/T 1038《消防公共服务平台技术规范》拟分部分出版，各部分将按照在消防公共服务平台的作用确立。下面列出本标准的预计部分：
——第1部分：总体架构及功能要求；
——第2部分：服务管理接口；
——第3部分：信息交换接口；
——第4部分：消防综合业务接口；
——第5部分：地理信息服务接口。
本部分为GA/T 1038 的第2部分。
本部分按照GB/T 1.1—2009 给出的规则起草。
本部分由公安部消防局提出。
本部分由公安部计算机与信息处理标准化技术委员会归口。
本部分起草单位：公安部沈阳消防研究所。
本部分主要起草人：张春华、傅永财、朱春玲、姜学赟、王佩青、吕建波、梁云杰、曾颖。
1 范围
GA/T 1038 的本部分规定了消防公共服务平台中服务管理平台（以下简称平台）对应用实体提供的软件接口（以下简称接口）功能及参数。
本部分适用于服务管理平台，以及需使用服务管理平台进行服务注册发布和服务查询调用的应用实体的开发和应用。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
GA/T 1038.1一2012 消防公共服务平台技术规范 第1部分：总体架构及功能要求
3 术语、定义和缩略语
GA/T 1038.1—2012 界定的术语、定义和缩略语适用于本文件。
4 平台接口
4.1 接口功能
4.2 接口参数
4.3 接口描述
4.4 调用结果消息代码
4.1 接口功能
服务管理平台提供服务注册发布和服务检索查询两类接口，接口的功能如下：a) 服务注册发布接口：提供服务注册发布及修改、服务订阅提交及修改、服务订阅通知方式提交及修改等功能；
b) 服务检索查询接口：提供服务查询、服务订阅查询和服务订阅通知方式查询等功能。
4.2 接口参数
4.2.1 类的定义
4.2.1.1 类名称和说明
平台接口使用的自定义类名称和说明见表1。
4.2.1.2 安全验证实体
用于封装安全验证信息，内容见表2。
4.2.1.3 服务责任人实体
用于封装服务责任人信息，内容见表3。
4.2.1.4 服务附件实体
用于封装服务附件，内容见表4。
4.2.1.5 代理服务实体
用于封装代理服务，参数见表5。
4.2.1.6 服务实体
用于封装服务信息，内容见表6。
4.2.1.7 服务注册发布及修改输入类
用于封装服务注册发布及修改输入信息，内容见表7。
4.2.1.8 服务注册发布及修改输出类
用于封装服务注册发布及修改输出信息，内容见表8。
4.2.1.9 服务查询条件实体
用于封装服务查询条件，参数见表9。
4.2.1.10 服务订阅实体
用于封装服务订阅，参数见表10。
4.2.1.11 服务订阅查询条件实体
用于封装服务订阅查询条件，参数见表11。
4.2.1.12 服务订阅通知方式实体
用于封装服务订阅通知方式，参数见表12。
4.2.1.13 服务订阅通知方式查询条件实体
用于封装服务订阅通知方式查询条件，参数见表13。
4.2.1.14 服务检索查询输入类
用于封装服务检索查询输入信息，内容见表14。
4.2.1.15 服务检索查询输出类
用于封装服务检索查询输出信息，内容见表15。
4.2.1.16 服务订阅查询输入类
用于封装服务订阅查询输入信息，内容见表16。
4.2.1.17 服务订阅查询输出类
用于封装服务订阅查询输出信息，内容见表17。
4.2.1.18 服务订阅提交及修改输入类
用于封装服务订阅提交及修改输入信息，内容见表18。
4.2.1.19 服务订阅提交及修改输出类
用于封装服务订阅提交及修改输出信息，内容见表19。
4.2.1.20 服务订阅通知方式查询输入类
用于封装服务订阅通知方式查询输入信息，内容见表20。
4.2.1.21 服务订阅通知方式查询输出类
用于封装服务订阅通知方式查询输出信息，内容见表21。
4.2.1.22 服务订阅通知方式提交及修改输入类
用于封装服务订阅通知方式提交及修改输入信息，内容见表22。
4.2.1.23 服务订阅通知方式提交及修改输出类
用于封装服务订阅通知方式提交及修改输出信息，内容见表23。
4.2.2 静态参数
静态参数的标识和取值见表24。
4.3 接口描述
4.3.1 服务注册发布接口
4.3.1.1 总体描述
实现服务注册发布及修改、服务订阅提交及修改、服务订阅通知方式提交及修改等功能，描述见表25。
4.3.1.2 服务注册发布及修改
服务发起方为服务的提供者，服务注册发布及修改输入、输出参数见表26。
4.3.1.3 服务订阅提交及修改
服务发起方为服务的使用者，服务订阅提交及修改输入、输出参数见表27。
4.3.1.4 服务订阅通知方式提交及修改
当订阅的服务发生变化时，通知服务订阅者的方式，服务发起方为服务的使用者，输人、输出参数见 表28。
4.3.2 服务检索查询接口
4.3.2.1 总体描述
实现服务检索查询、服务订阅查询、服务订阅通知查询等功能，描述见表29。
4.3.2.2 服务检索查询
服务检索查询输入、输出参数见表30。
4.3.2.3 服务订阅查询
服务订阅查询输入、输出参数见表31。
4.3.2.4 服务订阅通知方式查询
服务订阅通知方式查询输入、输出参数见表32。
4.4 调用结果消息代码
调用结果消息在返回的message 属性中，代码和含义描述见表33。
