福建省互联网医院监管平台数据监管接口规范试行稿修订版v15.docx

《福建省互联网医院监管平台数据监管接口规范试行稿修订版v15.docx》由会员分享，可在线阅读，更多相关《福建省互联网医院监管平台数据监管接口规范试行稿修订版v15.docx（46页珍藏版）》请在第一文库网上搜索。

1、福建省互联网医院监管平台数据接口规范（试行稿）福建省卫生计生信息中心2019年11月25日目录修订记录4第一章接口规范说明51.1. 网络环境要求51.2. 加解密规则513.调用平台接口513.1. 服务地址513.2. .输入说明513.3. 输出说明513.4. 接口处理状态代码说明613.5. .接口清单及调用频率要求613.6. .调用示例(Java)7第二章接口明细82.1. 接口用户信息82.2. 医院基本信息82.3. 医师基本信息112.4. 获取监管平台医师唯一标识132.5. 网上预约挂号132.6. 在线医技预约142.7. 医生评价信息162.8. 网络咨询服务信息1

2、72.9. 网络诊疗服务信息192.10. 电子处方表212.11. 电子处方药品明细表242.12. 在线诊疗服务信息-过程图片上传252.13. 用户协议信息262.14. 数据上传汇总信息26第三章字典规范281 .机构等位分级NS.00.001282 .经济类型NS.00.002283 .组织类别NS.00.003294 .单位隶属NS.00.004295 .所在地区NS.00.005326 .国家诊疗科目编码NS.00.006347 .拟开展互联网医疗服务NS.00.007388 .医师职业类别NS.00.008389 .医师职务NS.00.0093910 .处方类别NS.00.01

3、03911 .性别NSQOQ113912 .监管不良事件类型NSQO.0124013 .监管不良事件等级NSQOQI34014 .不良事件主题NSQOQ144015 .处置状态NSQO.0154016 .备案类别NS.00.0164117 .审核明细类型NS.00.0174118 .协议类型NS.00Q184119 .上传状态NS.00Q194120 .监管审核状态NSQO.0204121 .记录状态NSQO.0214222 .申请状态NS.00.0224223 .是否NSQo.0234224 .电子病历等级NSQOQ244225 .诊断类型NS.00.0254226 .咨询或就诊NS.00.

4、0264327 .疾病分类NS.00.0274328 .行动不便标志NS.00.0284329 .长期服药标志NS.00.0294330 .咨询类别NS.00.0304331 .咨询属性NS.00.0314332 .诊疗类别NSQo.0324433 .患者费别NSQO.0334434 .保险类别NS.00.0344435 .证件类型NS.00.0354436 .就诊卡类型NS.00.0364437 .用药频率NS.00Q3745第四章子集说明464.1.聊天记录子集zj.00.00146修订记录版本号修订内容修订人修订时间1.()初稿2019-051.1 增加修订记录章节： 更新接口文档中的备

5、注说明 2.2医院基本信息接口增加患者投诉绿色通道字段； 2.2医院基本信息接口信息系统安全等级保护级别及文件修改为必填项，文件为图片形式上传 各接口患者年龄字段数据格式更新为decima1 2.6在线医技预约接口中操作医师更新为非必填项 2.10电子处方表接口增加审方时间字段 2.11电子处方一药品明细表增加批准文号，国家药品编码、药品电子监管码和用药天数字段 新增2.12在线诊疗服务信息-过程图片上传接口 新增2.13用户协议信息接口2019-111.2 调整部分备注文字 用户协议信息接口，协议内容字段类型调整未text2019-121.32.6在线医技预约接口增加“预约项目名称”字段20

6、23-021.4 新增2.14数据上传汇总信息接口 网络诊疗和网络咨询服务修改字段患者咨询内容和诊疗过程文件字段为必填,修改咨询内容格式。 新增4.1聊天记录子集2023-031.5更新2.3医师基本信息诊疗科目代码，诊疗科目名称，执业证书编号等字段的必填说明2023-03第一章接口规范说明对各机构分配唯一认证码，作为数据权限安全认证，同时通过数据请求的ip认证该请求客户端是否具有请求服务权限。为保证数据传输安全，要求数据经过加密后通过政务外网传输到平台1.1. 网络环境要求政务外网（卫生健康专网）1.2. 加解密规则接口数据请求采用AES对称加密，AeSEnCOdeKey由平台生成分配给各机

7、构，接口调用的请求数据和返回数据都通过AeSEnCOdeKey进行加密和解密，确保接口调用的安全性。1.3. 调用平台接口1.3.1. 服务地址http:IOI20.102.20238081miccWSaPi/1.0?WSd11.3.2. 输入说明参数数据类型是否必输描述tokenString是临时口令，用于安全校验dataString是传入的数据，其形式为json字符串，数据明细内容参见接口明细。1.3.3. 输出说明参数名称数据类型是否必须描述msgidString1消息确认ID,监控平台确认接收到接口调用后，会生成该id,用于标记此次收到的数据statusString1消息接收状态，其中

8、1表示接收成功，0表示接收失败。msgString接口处理结果格式为json字符串，详情请参考：5.2.4接口处理状态代码说明。13.4.接口处理状态代码说明消息代码说明200成功40001非法请求token40002非法请求ip,ip不在白名单40003密钥校验格式错误，请与管理员联系40004密钥校验失败，请与管理员联系40005您没有申请密钥，请与管理员联系40006字符串加密失败40009接口服务调用失败41001数据请求异常41(X)2统一社会信用代码未在系统中备案41(X)3数据转为JSOn失败41004拟拓展互联网服务字典值转换失败41005医师职务字典值转换失败41006国家诊

9、疗科目字典值转换失败135接口清单及调用频率要求序号接口名称接口方法调用频率1.接口用户信息mice.UpNsUserToken调用业务接口时申请2.医院基本信息micc.upNsOrganBase新增修改3.医师基本信息mice.UpNsDoctorRecord新增修改4.获取监管平台医师唯一标识micc.achNsDoctorRecord调用有关业务接口时申请5.网上预约挂号mice.UpAppointmentOn1ine次日0点到6点上传本日数据6.在线医技预约mice.UpMedica1On1ine次日0点到6点上传本日数据7.医生评价信息mice.upNSDoctorScore次日0

10、点到6点上传本日数据8.网络咨询服务信息micc.upNsOn1ineAsk次日0点到6点上传本日数据9.网络诊疗服务信息mice.UpNsOnIineMed次日0点到6点上传本日数据10.电子处方表mice.UpPrescription次日0点到6点上传本日数据11.电子处方一药品明细表mice.UpPrescriptionDrug次日0点到6点上传本日数据12.在线诊疗服务信息-过mice.UpNsOn1ineImg次日0点到6点上传本日数据程图片上传13.用户协议信息mice.upNsOrganProtoco1新增修改14.数据上传汇总信息mice.UpNsInvokeTota1每天次日

11、业务数据上报前需上传业务统计总数1.3.6.调用示例(Java)pub1icstaticvoidmain(Stringargs)throwsExceptionEncryptwebServiceEntryProxyproxy=newEncryptWebServiceEntryProy();proxy.setEndpoint(http:/10.120.102.202:18081/micc/wsapi/1.0?wsd1);EncryptWebServiceEntryservice=proy.getEncryptWebServiceEntry();JSONObjectjb=newJSONObject(

12、);jb.put(cd_user,demo);jb.put(pwd_user,demo);JSONArrayjsonArray=newJSONArray();jsoArray.add(jb);/StringencryptParams=AESUtiIs.encrypt(JSONUtiIs.toString(newString,tokenJsonArray.toString()zAesEncodeKey);token:调用接口用户信息接口获取token(调用接口用户信息接口token为nu11)/AesEncodeKey:开发人员向平台工作人员索取StringencryptParams=AESUt

13、i1s.encrypt(JSONUti1s.toString(newString7GBKtZKD3gGI6e7501jsonArray.toString(),5ff7db748e839782);/Stringresu1t=service.invoke(appidz,serviceidzserviceMethodzencryptParams);/appid:根据接口明细提供对应的密钥偏移量固定值SerViCeid:根据接口明细提供对应的id/ServiceMethod根据接口明细提供的methodStringresu1t=service.invoke(bbp,micc.upNsOrganBase

14、,execute,encryptParams);System.out.print1n(+AESti1s.decrypt(resu1t,5ff7db748e839782);第二章接口明细以下各个数据接入标准定义，数据类型默认为字符串型，长度默认不限制。数据项需要参见字典时，如果字典项没有定义的话，编码填u-r,名称填互联网医院内部使用名称。所有涉及到金额的数据，默认单位为元（元字省略），数据类型为字符串型。所有涉及到照片上传的base64数据，200KB只是折中考虑照片清晰度和大小的经验值,允许适当增大，照片数据首先还是要保证清晰度。2.1接口用户信息接口参数appid:ihspServiceidimicc.UpNsUserTokenServiceMethodiexecute说明向互联网医院监管平台推送-