病案首页采集.PDF

病案首页采集 接口说明书 版本: V1.0 泰康保险集团 2019 年5 月 成文信息 主题词： 微服务、API、结算、接口 作 者： 文档类别： 技术方案、设计文档 审 核： 批 准： 文档性质： 主 送： 存档日期： 2019.5.29 抄 送： 发布日期： 签收信息 发送方 接收方： 接收方： 接收方： 代表人： 代表人： 代表人： 代表人： 日期： 日期： 日期： 日期： 变更信息 版本 原因 作者 日期 V 1.0 2019.5.29 目录 第一章 引言 5 1.1 编写目的 5 1.2 背景 5 1.3 目标 5 第二章 API 规范 5 2.1 访问路径 5 2.2 服务版本 5 2.3 访问地址 5 2.4 过滤信息 6 2.5 状态码 6 2.6 返回值 6 第三章 流程及接口服务设计 7 3.1 业务及接口调用规则 7 3.2 接口设计 7 3.2.1 病案首页采集接口 7 3.2.2 病案首页作废 19 第四章 代码表说明 20 4.1 医疗付款方式代码 20 4.2 性别代码 21 4.3 民族代码 21 4.4 职业代码 23 4.5 婚姻状况代码 24 4.6 联系人关系代码 24 4.7 入院途径 24 4.8 入院病情代码 25 4.9 血型编码 25 4.10 RH 25 4.11 病案质量 26 4.12 手术级别 26 4.13 切口愈合等级 26 4.14 切口愈合类别 26 4.15 离院方式 27 4.16 有无 27 第一章 引言 1.1 编写目的 本说明文档对长期照护经办系统和专业系统关于结算部分的交互流程和接 口做了定义和说明，开发及设计人员可以参照本说明文档进行开发和设计。 1.2 背景 1.3 目标 第二章 API 规范 RESTful API 是目前比较成熟的一套互联网应用程序的API 设计理论。本文 将遵循RESTful API 标准进行设计微服务的API 。 2.1 访问路径 在服务地址URL 中定义主域名下定义api 目录 例如：http(s):///api/ 2.2 服务版本 将服务的版本号放入URL 中 例如：http(s):///api/v1/ 2.3 访问地址 在RESTful 架构中，每个网址代表一种资源（resource ），所以网址中不能 有动词，只能有名词，而且所用的名词往往与数据库的表格名对应。一般来说， 数据库中的表都是同种记录的集合 （collection ），所以API 中的名词也应该使 用复数。一个API 提供用户（user ）的信息，地址如下所示： http(s):///api/v1/users/ID 获取某个指定用户的信息 2.4 过滤信息 如果需要对服务返回的信息进行过滤，客户端应该提供参数，服务器根据用 户提供的参数对目标数据进行过滤，格式如下所示： http(s):///