全民健康保障信息化工程

《全民健康保障信息化工程》由会员分享，可在线阅读，更多相关《全民健康保障信息化工程（14页珍藏版）》请在装配图网上搜索。

1、全民健康保障信息化工程集成规范（服务）二o九年二月目录1. 概述 12. 服务管理体系 13. 服务调用申请流程 24. 服务发布申请流程 35. 服务调用方法及原则 46. 服务集成规范 57. 服务调用控制 78. 服务监控 79. 附录 81. 概述为规范国家卫生健康委服务管理系统服务管理流程,服务申请、服务调用及 服务监控，确保服务治理的可观测试性，结合实际工作情况，特制定此管理办法。 本办法用于规范国家卫生健康委服务管理系统服务接口申请、授权和使用的行为 和流程。国家卫生健康委服务管理系统服务接口申请、授权和使用管理遵循以下 原则：（一）统一受理。国家卫生健康委数据服务管理系统服管理

2、部门统一受理和 答复国家卫生健康委各部门的服务接口使用申请。（二）按服务接口授权。原则上服务接口授权对象为服务申请机构（服务调 用厂商）。服务申请部门在提出申请时，需提供信息使用用途和业务应用系统等 信息。（三）与全民健康保障项目其他服务衔接。依托国家电子政务外网建设国家 卫生健康委员会政务服务管理系统，实现与全民健康保障平台的对接。国家卫生 健康委服务管理系统上线运行后，对于各厂商实现的业务系统提供服务支撑需求 由国家卫生健康委服务管理系统统一受理和提供服务，并通过国家卫生健康委员 会服务管理系统交换数据。2. 服务管理体系国家卫生健康委服管管理系统由服务资源目录、服务调用及发布申请流程、

3、服务授权、服务监控共同组成。服管管理模型如下图所示：他迥K背乞卑ESB 釣師丄具组件貼务注卅璀布两科嗨式：A錨代怨R爲封芸” Frl矚 MME 昔疊ti 1M55HB两那务:业势协间类诽3. 服务调用申请流程第一步：申请，不管是要调用平台上的其他服务，还是把自身业务系统上的 某些服务发布到服务管理系统；在全民健康平台门户上可以看到已经发布的服务 资源目的，可提交访问申请,也可以提交服务发布的申请;服务调用申请信息（包 括服务申请方、申请理由、信息使用用途、联系人及联系方式等），服务发布申 请信息（包括服务发布方、发布理由、所发布服务说明、所属业务系统，服务接 口使用手册，服务接口访问URL,联

4、系人及联系方式，服务调用申请审核方式等）， 发布或是调用申请,一次只能一个接口。第二步：审核，申请提交后，国家卫生健康委服务管理系统管理部门应于3 个工作日内完成服务接口申请材料的规范性检查，并通过国家卫生健康委全民健 康保障平台门户系统回复受理意见。不予受理的，应说明具体原因；为简化授权 流程，服务发布方可将服务接口整体授权给国家卫生健康委服务管理系统管理部 门进行服务调用审核。第三步：获得调用服务授权token，调用申请提交后，由平台管理员或服务 提供方时行审核，审核通过后，会生为申请者生成一个调用授权的token,调用的 该接口时，要带着审核通后生的token。第四步：服务接口变更，原则

5、上不接受变更，接口变更可采用新增一新接口重新发布。第五步：服务接口申请、授权主要流程图国家卫生健康委数据共享交换系统服务接口申请、授权流程图是服务申请方平台管理方服务提供方不予受理信息结束统一受理申 请，受理材授权登录数据共享交换 系统，填写授权意服务接口授权 申请通过厂L开始用户注册。访问国家全民健 I康信息平台，进行审批通过后，登 录国家全民健康信 息平台，查看资源I 服务目录发起接口使用申 请，提交申请表扫 描件1、接收数据共享 交换系统管理方回复。申请答复否平台代为授权统一受理 通过数据共享交换 系统将申请表转交 给服务提供方不予受理4. 服务发布申请流程第一步：提交发布申请，服务发布

6、方在全民健康保障平台门户，资源目录地， 可提交服务发布申，服务发布申请信息，包括服务发布方、发布理由、所发布服 务说明、所属业务系统，以附件形式提交的服务接口使用手册，服务接口访问 URL，心跳检测URL,联系人及联系方式，服务调用申请审核方式等，另外如是 webservice形式的服务接品，还要包含wsdl访问地址，webservice可用WSDL 进行心跳测试，心跳测试URL可为空。服务接口只能是webservice或restful 形式的接口，详见服务规范章节。第二步：审核，由国家卫生健康委服务管理系统管理部门进行审核，国家卫 生健康委服务管理系统应在受理申请后的 3 个工作日内完成授权

7、。授权不通过的 应说明具体理由。第三步：发布，审核通过后，运营人员按申请信息，把服务注册到总线上， 并把注册到总线上的服务同步到服务资源目录中。给调用者分取確 邑（用户廻划用f帯有调用* 者ID、厂商ID、 token、requestld）第四步：服务发布流程及服务被调用流程图：即膏樋入岌BftftA(SK#ttX 偿4trs5M布）申滴布）审批(eersiD)IF浦加赛户（论蓋gg扫托徜胡“根密责憑目录进丄服势同出给資通用户容、雷码）脈7?叨1口甲FHw行眶势访问申青w目累5. 服务调用方法及原则一、责任及数据安全使用方应严格遵守国家相关法律法规，按照授权的方式和范围使用服务接口 不得用于授

8、权范围之外的信息系统，不得直接或间接改变数据形式后提供给第三 方，也不得用于其他目的。如发现使用方违规使用、超范围使用、存在安全风险 等情况，提供方有权暂停或终止服务。服务申请方应在授权期限内使用服务接口，期满后需重新申请。对于服务申 请方获得授权后超过六个月不使用服务接口的，除季节性应用需求等特殊情况外 服务提供方可视情况收回服务接口授权。二、调用过程调用时，要带着申请时获得的to ken,也就是在header中要带一个参数Authorization,其值为申请是所得token,该参数并不是服务提供方原生服务接 口使用的参数，只是为了便于管理，在服务管理网关上使用该放置于header中 的参

9、数，进行鉴权。6. 服务集成规范一、服务集成模式服务代理：符合接口标准，接口规范类的restful或webservice类接口， 直接注册到服务总线上，总线只是对所注册的服务进行代理，以及对其的访问进 行控制。服务包装：对第三方不符合接口规范,且不可更改的服务，如公安人口相关 服务，支撑平台包装成符合规范的服务后再注册到总线上。二、服务接口原则 采有非侵入式服务管理，即不改变所接入服务的参数，只约定了响庆数据结构，服务访问控制通过在请示的header中，附加to ken的方式。三、服务接口方式支撑平台采用，SOA架构设计，遵循SOA设计原则和技术标准，提供松耦合 模式，实现业务逻辑和应用逻辑、

10、数据逻辑等分离。a）提供基于SOAP协议的web服务接口，或是基于restful协议的web 服务接口。b）支持跨语言、跨操作系统调用。三、服务接口标准a）WS消息方式Web service是一个跨语言的，松耦合、平台独立的、基于可编程的web的 应用程序，可使用开放的XML标准来描述、发布、发现、协调和配置这些应用程 序，用于开发分布式的互操作的应用程序。平台定义的WS消息交换接口满足SOAP 1.1 SOAP 1.2 WSDL1.1 WSDL2. 0标准规范。WS接口定义说明性描述主要由以下几部分组成:接口说明：定义和说明接口的作用和适用范围场景说明：定义和描述WS服务接口的调用和使用场景

11、、说明业务处理 流程； 服务地址：描述WS服务的调用URL地址；请求数据结构：以wsdl中定义的为准，只是在请求的header中要带一个参数Authorization,其值为所得token，参见第五章服务调用响应数据结构：定义和描述WS服务的响应数据结构和参数说明。响应数据分为4部分，结构和restful Response 一样，只是XML格式在WSDL 中要定义如下Response应答消息结构：RestfulResponse应答消息xml格式,这里以JSON格式来表述msg： ,/请求应答提示success: t rue,/true 请求成功，false 失败stat us: 200,/s

12、tat us为200是表示成功，其他为错误代码data: Object返回的数据集Object,具体数据结构由接口接入方定义，这里只是一个抽 像说明。b) restful消息方式API 定义如下：接口 URLhttp:/域名 /XXX Api/version/请求方式GET/P0ST接口描述Res请求消息Request应答消息ResponseXXX API中的XXX对应注册上来的业务系统简称英文名，Version为API版 本，参数也可以 PathVariable 形式，如：/restUrl/id请求数据结构：由接口提供方定义，只是在请求的header中要带一个参数Authorization,

13、 其值为所得token，参见第五章服务调用应答消息,json格式：msg: ,/请求应答提示success: t rue,/true 请求成功，false 请求失败stat us: 200,/s tat us为200是表示成功，其他为错误代码data: Object返回的数据集Object,具体数据内容与相应业务代码对应。7. 服务调用控制一、限流保护防止因过截而使服务提供方的服务崩溃，按服务提供方的吞吐量设置限流。二、访问频次控制访问频次在一定时间内，超出正常频率频繁访问将被禁止访问。三、访问鉴权如服务调用中，在header中不含授权token,将被拒绝访问。四、t oken有效期由申批时按

14、调用申请中的描述，设置token有效期，过期后也不能访问所申 请的服务。8. 服务监控一、服务调用日志分析服务被频用频率，及服务响应时间，分析服务的可用性，可靠性，以及 日均调用次数，并对访问者进行审计。二、服务心跳检测对于webservice形式的服务，服务管理系统直接访问对应的wsdl,进行心 跳测试，连续三次心跳不通过，设置为服务不可用，后续心跳测试通过再更新为 可用状态；restful形式有服务，按服务提供方所给的心跳接口进行测试，心跳 接口无须返回数据，简单返回success即可。在服务资源目录中可查看到当前服 务的状态。三、建立评价反馈机制国家卫生健康委服务管理系统管理部门定期汇总

15、统计服务接口授权办理情 况、服务接口调用和可用性情况等，并在国家全民健康信息平台公布。对于未在 规定时限内完成服务接口授权的，或者由于服务接口中断服务对使用方业务造成 较大影响的，报国家卫生健康委服务管理系统通知整改。9. 附录服务调用申请单服务接口申请表信息项目内容说明服务接口提供单位名称填写所要申请的服务接口名称，申请一个服务接口需填与张申请表申请服务接口名称提供方代码填写实际使用单位的代码提供方名称接口使用单位名称业务信息信息用途及应用场景描述使用服务接口信息 完成的具体业务场景描 述，预期应用效果等，应具体到政务服务事项 的某一活动环节。接口使用期限接口服务使用期限，以 天为单位，最长

16、不超过 1095天。除季节性应用 需求等特殊情况，需标 明每年使用情况，如：1 月1日-5月1日、7 月1日-9月1日等申请依据描述提供方完成上述业 务应用的相关法律、法 规、政策具体依据使用单位联系人姓名、电话及邮箱技术信息业务系统名称业务系统的政务外网IP业务系统服务器使用的国家电子政务外网公共区IP地址业务系统部署地占八、详细说明业务系统部署的地点服务接口每天使用频次服务接口每天使用次 数,标明平均值和峰值， 如平均200次/天、峰 值10000次/天服务接口使用时如工作日，每天8:00间范围到 20:00接口使用其他技术请求基于特定服务接口的具体技术要求，可另附表格详细说明经办人（签字）申请单位：申请日期：全民健康保障信息化工程