金华城市用血实时联网平台接口规范.docx

《金华城市用血实时联网平台接口规范.docx》由会员分享，可在线阅读，更多相关《金华城市用血实时联网平台接口规范.docx（41页珍藏版）》请在第一文库网上搜索。

1、金华城市用血实时联网平台接口规2023年5月目录目录1文档介绍51.1 文档目的51.2 文档范围51.3 术语与缩写解释62接入准则72.1 接入指南72.1.1 接入环境72.1.2 接入拓扑图72.1.3 交互频度72.2 请求结构82.2.1 请求地址82.2.2 字符编码82.2.3 数据类型说明82.3 通讯技术92.3.1 SOAP92.3.2 WSD192.3.3 WebService92.4 访问控制92.4.1 获取Token92.4.2 使用Token92.5 HTTP状态码103接口规范113.1 认证接口113.2 获取基础数据接口113.2.1 获取医院机构字典11

2、3.2.2 获取血站机构字典123.2.3 获取血液品种字典133.3 医院血液预订接口143.3.1 提交血液预订单143.3.2 取消血液预订单153.3.3 根据过去一周查询血液预订单状态16334根据预订单号查询血液预订单详情173.4 血站发血交接单入库接口193.4.1 根据交接单号查询血站往医院出库单详情193.4.2 医院接收确认血站交接单213.5 提交医院库存信息213.5.1 提交当前库存血袋汇总信息213.5.2 提交当前库存血袋明细信息233.6 提交医院接收血站发血入库信息243.7 提交医院输血申请信息253.8 提交医院出库到临床信息293.9 提交医院血袋报废

3、信息323.10 提交医院输血不良反应信息334错误响应354.1 错误响应354.2 错误响应格式354.3 错误码355数据字典375.1 ABO血型375.2 Rh(D)IfI1S375.3 出入库类型375.4 身份证件类型385.5 医院科室代码385.6 输血目的代码405.7 输血申请类型405.8 血液失效原因405.9 输血反应类型411文档介绍1.1 文档目的本规范适用于穿越医院联网管理平台与医院相关系统之间、以及与各外部数据系统之间的同步数据交换传输。规范规定了传输过程中系统结构、协议与通讯模式。本规范适用于通过接口实现从医院输血科系统把医院临床用血信息实时数据上报的医院

4、，不适用于没有使用输血科系统的医院。1.2 文档范围本文阐述内容仅限穿越医院联网管理平台对接标准接口规范,对业务流程不做详细阐述。本文档阐述内容囊括医院临床用血信息联网所需要的所有接口,医院需要严格按照标准规范进行匹配，以保证医院与城市用血实时联网平台的对接，实现全市用血信息业务数据同步。1.3 术语与缩写解释序号缩写、术语解释说明1HTTPBasicAuthenticationHTTPBasicAuthentication是一种允许客户端提供用户名和口令为凭证的形式访问受保护的资源2HIS系统医院信息管理系统简称31IS系统实验室信息管理系统简称4BIS系统血站信息管理系统简称2接入准则2.

5、1 接入指南血站搭建部署在卫生专网开放的标准化接口，医院通过调用标准化接口，上报临床用血情况等信息。从而实现数据的交互。标准化接口采用HTTP/HTTPS协议，发布接口API,由各联网医院的“输血科系统”单向调用接口API,进行数据传输。2.1.1 接入环境接口程序能够访问：政务网http:/:/hos1inkws/services/Hos1ink?wsd12.1.2 接入拓扑图2.1.3 交互频度数据上报为保证信息的及时性，业务数据要求在业务发生时及时上报，当天的库存统计数据需要在当天晚上12点前上传。调用控制血液中心发血数据具有实时性，血液中心发出血液的业务完成后，医院需通过接口获取发血单

6、信息及血液制品信息。为保证接口服务的调度，接口请求进行了流量控制，每个IP每秒5次，每分钟15次。超出请求控制的请求会被拒绝。2.2 请求结构2.2.1 请求地址服务地址WebService:http:/:/hos1inkws/services/Hos1ink?wsd1通讯协议使用HTTP协议，支持通过HTTPS协议2.2.2 字符编码请求及返回结果都使用UTF-8字符集进行编码。2.2.3 数据类型说明数据类型的描述规则见下表:数据类型表示符描述定长字符串型字符长度表示符（N）,其中N表示该字符串的长度变长字符串型字符串在字段描述中定义最大长度数字型数字长度表示符（N,M）,其中N表示该数字

7、的最长长度，包括整数位数、小数点（算一位）、小数位数；M表示该数字的最长小数位数布尔型布尔用字符“1”表示true,字符“0”表示fa1se日期型日期用定长字符串表示，格式为YYYY-MM-dd日期时间型日期时间用定长字符串表示，格式为YYYY-MM-ddHH:mm:ss,24小时制二进制型二进制二进制数据类型，如图象、音频、视频等二进制流文件格式。2.3 通讯技术通过适配器，客户端连接到中心端开放的WebSerVice,在同步传输技术中使用到了下面的技术。2.3.1 SOAP简单对象访问协议(SimP1eobjeCtACCeSSPrOtoeoI),SOAP是基于XM1的简易协议，可使应用程序

8、在HTTP之上进行信息交换。或者更简单地说：SOAP是用于访问网络服务的协议。2.3.2 WSD1WSD1指网络服务描述语言(WebServicesDescription1anguage)999-1,datamu11,msg:错误信息成功返回codeQ,data1institutionJSON,msg:巧institution天!象说明属性名数据类型长度属性说明id数值16机构IDname字符串32机构名称avai1ab1e数值40-无效；1-有效返回结果InstitutionJSON格式:code:。，data:id:3,name:宁德市医院,，avai1ab1e:1)3.2.2 获取血站机

9、构字典描述获取平台上所有血站机构字典，包括分血站。方法String1istStation(Stringtoken);参数说明Stringtoken:访问token返回值code:,data:，msg:失败返回code:-999-1,data:nu11,msg:错误信息成功返回code:OJdata:Station,m$g：Station对象说明属性名数据类型长度属性说明dept1d数值16机构IDname字符串32血站名称返回结果Station格式：(msg:查询成功,code:,0,data:dept1d:,name1:XX血站,dept1d:,name:XX血站3.2.3 获取血液品种字典

10、描述获取平台上血液品种信息字典。血液预定和血站发血等信息，需要根据统一血液品种来分类数据。方法String1istB1oodType(Stringtoken);参数说明StringtOken:访问token返回值code7datar,7msg:)失败返回code*999-1,datamu11,msg:错误信息成功返回code:Ozdata:b1oodTypeJSON,msg:successb1oodType对象说明属性名数据类型长度属性说明id数值8血液品种idname字符串32血液品种名称unit字符串4血量单位：M1-代表亳升；U-代表单位avai1ab1e数值40-无效：1-有效返回结果HoodTypeJSON样例：code:,0,data:(id:1,name:单采血小板，avai1ab1e:13.3 医院血液预订接口3.3.1 提交血液预订单描述向血站平台提交血液预订单，定义所需要血液品种的血量，血型等信息方法StringnewBooking(Stringtoken,StringbookingJSON);参数说明Stringtoken:访问tokenStringbookingJSON:血液预订单JSON返回值code:,data:,msg:失败返回code:-999-1,Pata1nuIIJmsg:错误信息