DB11-T1391-3-2017网格化社会服务管理信息系统技术规范第3部分：通用数据接口

1、ICS 35.240L 73备案号:54170-2017DB11北京市地方标准DB11/T 1391.32017网格化社会服务管理信息系统技术规范第 3 部分：通用数据接口Grid social services and management information system technical specificationPart 3:General data interface2017 - 03 - 22 发布2017 - 07 - 01 实施北京市质量技术监督局发 布DB11/T 1391.32017目次前言II范围1缩略语1接口架构1整体框架1调用流程1技术要求2接口调用信息结构2请

2、求信息结构2返回信息结构4异常处理5重试机制5事务机制5安全要求5用户认证5信息加密5备份5附录 A（资料性附录）通用数据接口使用示例6IDB11/T 1391.32017前言DB11/T 1391网格化社会服务管理信息系统技术规范分为以下3个部分：第1部分：总则；第2部分：数据；第3部分：通用数据接口。 本部分为DB11/T 1391的第3部分。本部分按照GB/T 1.1-2009给出的规则起草。本部分由北京市社会建设工作办公室提出并归口。本部分由北京市社会建设工作办公室组织实施。本部分的起草单位：北京市社会建设工作办公室、北京市密云区社会建设工作办公室、北京长风信息技术产业联盟、北京数字政

3、通科技股份有限公司、方正国际软件有限公司、首都信息发展股份有限公司、北京有生博大软件技术有限公司、北京国研数通软件技术有限公司、北京中关村科技发展（控股） 股份有限公司。本部分的主要起草人：王丽竹、刘志杰、唐志华、杨国林、李浩、张同银、纪海明、冷祯鹏、宗君、王晓娟、张婷、曹芹、李悦、庞奎、徐峰、赵斌、吴传强、常利红、吴花春、黄雷。IIDB11/T 1391.32017网格化社会服务管理信息系统技术规范 第 3 部分：通用数据接口范围本部分规定了网格化社会服务管理信息系统中通用数据接口的接口架构、接口调用信息结构、异常处理及安全要求。本部分适用于各级网格化社会服务管理信息系统之间、各级网格化社会

4、服务管理信息系统与相关外围信息系统之间的信息采集、处理与共享交换。缩略语SOAP 简单对象访问协议（Simple Object Access Protocol)WSDL Web Service描述语言（Web Services Description Language） XML可扩展标记语言(Extensible Markup Language)XSDXML结构定义 (XML Schema Definition )接口架构整体框架通用数据接口实现机制如图1。图1通用数据接口框架结构图网格化社会服务管理采用基于SOAP协议的Web Service技术来实现不同系统之间的信息传输；进行信息传输的各

5、子系统应通过发布Web Service服务，提供数据交换接口，从而实现数据、业务的交互。网格化社会服务管理系统中的运行管理子系统对访问接口的对接系统进行身份认证和权限认证。调用流程接口调用流程如图2所示。1网格化社会服务管理系统Web Service服务DB11/T 1391.32017返回结果服务请求对接系统图2接口调用流程具体流程如下：各对接系统向 Web Service 服务发送服务请求；Web Service 服务收到服务请求后，进行相应的操作并返回结果；Web Service 服务宜支持以下四种调用模式:简单请求应答模式，即一次请求对应一次应答或者没有应答；多次应答模式，即一次请求对

6、应多次应答；混合应答模式，即对请求后的应答不能完成全部数据传送，网格化社会服务管理信息系统还需要通过其他方式把完整数据提供给服务请求方；订购通知模式，即服务请求方订购网格化社会服务管理信息系统发布的主题，当与订购主题相关的事件发生时，网格化社会服务管理信息系统通知服务请求方。技术要求接口技术要求包括：信息描述语言遵守 WSDL Version1.2。XML 数据的消息格式遵守 SOAP 规范。XML 数据使用 XSD 进行描述。编码格式采用 UTF-8。接口调用信息结构请求信息结构接口的请求信息采用XML格式，其XSD定义如图3所示。请求信息分成两个部分：第一部分是控制信息，包括协议版本、服务

7、请求系统ID、服务请求ID、加密方案、请求者身份等；第二部分是请求信息的具体内容。请求信息的扩展方法可参考附录A。2DB11/T 1391.32017图3请求信息 XSD请求信息XML格式见图4，请求信息XML标签含义见表1。图4请求信息 XML 格式3DB11/T 1391.32017表1请求信息 XML 标签含义序号XML 标签标签说明1DataCenterXML根标签2Request服务请求信息子标签3Version协议版本号4SystemID服务请求系统 ID5SessionID服务请求 ID6EncryptionScheme加密方案，即对后续各 XML 元素内容进行加密时采用的加密方

8、式。0 表示不加密7Authentication请求者身份子标签8UserName用户名称9Password用户密码10Ext1预留标签，用于扩展后续控制信息11Ext2预留标签，用于扩展后续控制信息12RequestData请求数据子标签，可以根据需要进一步扩展返回信息结构接口的返回信息采用XML格式，其XSD定义如图5所示。请求信息包括两个部分：第一部分是控制信息，包括服务请求ID和加密方案；第二部分是返回信息，包括返回状态和返回数据。返回数据的扩展方法可参考附录A。图5返回信息 XSD返回信息XML格式见图6，返回信息XML标签含义见表2。4DB11/T 1391.32017图6返回信息

9、 XML 格式序号XML 标签标签说明1DataCenterXML根标签2Response返回信息子标签3SessionID服务请求 ID4EncryptionScheme加密方案，即对后续各 XML 元素内容进行加密时采用的加密方式。0 表示不加密5ReturnMessage返回状态子标签6Code返回代码7Message返回状态信息8ResponseData返回数据子标签，可以根据需要进一步扩展表2返回信息 XML 标签含义异常处理重试机制调用方调用数据接口服务，最多尝试3次，即： 第1次调用失败、出现异常，重新调用该接口； 第2次调用失败、出现异常，再次调用该接口； 第3次调用失败，出现

10、异常，则不再重试。事务机制在调用数据接口进行提交、修改、删除等数据操作时，应提供事务处理机制。安全要求用户认证5DB11/T 1391.32017应提供对数据接口服务调用者的认证机制。a）服务调用者在调用接口服务时应对调用者进行身份验证；应定期对身份验证信息进行更新； b）宜为不同的服务调用者分配不同权限；c）宜为不同的操作限定不同的交互方式。在进行提交、修改、删除等数据操作时，宜针对每次操作分别进行身份认证；在进行查询操作时，可以采取一次身份认证多次查询的方式。信息加密宜对请求参数中的身份元素和返回参数中的敏感数据进行加密处理；对 XML 加密可参照 W3C 组织的 XML 加密标准；加密方

11、法宜采用对称加密和非对称加密相结合的方法。备份数据接口服务的服务器宜提供双机热备。6DB11/T 1391.32017附录A（资料性附录） 通用数据接口使用示例本示例适用于各级网格化社会服务管理信息系统之间、各级网格化社会服务管理信息系统与相关外围信息系统之间的数据接口服务调用设计和应用。本示例以某信息系统向某区级网格化社会服务管理信息系统调用“查询街道信息”接口服务为例，说明通用数据接口的设计和使用方法。功能本示例实现的功能是通过街道编码查询街道信息。接口扩展设计在实现某些具体业务需求时，应对通用数据接口进行进一步扩展设计。对通用数据接口的扩展设计包括交互模式定义、请求信息的RequestD

12、ata标签扩展定义和返回信息的ResponseData标签扩展定义。本示例交互模式选择简单请求应答模式，RequestData标签和ResponseData标签的扩展定义见表A.1。表A.1接口扩展信息 XML 标签含义序号XML 标签标签说明1ReqestType请求服务类型。在 RequestData 标签下。应为所有数据接口服务定义请求服务类型代码。如：getStreeInfo：查询街道信息getCommunityInfo：查询社区信息2StreetID街道 ID 号。在 RequestData 标签下3StreetName街道名称。在 ResponseData 标签下4StreetAddress街道地址。在 ResponseData 标签下5Code0：成功-1：调用的服务不存在-2：没有查到符合条件的信息请求信息请求信息的XML格式见图A.1。7DB11/T 1391.320171.0100 98563465324 0user100 psd100 getStreetInfo 123456