黄石妇幼前置接口文档(赛思软件)

修订历史
(*PS：文档版本号修改规则
三位限定，为主版本号、次版本号、修订号；若上级版本号修改，后面版本号置0，
若重大修订，主版本进1，若新增、删除接口，次版本号进1，若修改接口内参数，修订号进1)

| 序号 | 日期 | 版本 | 变更类型 | 变更人 | 备注 |
| --- | --- | --- | --- | --- | --- |
| 1 | 2024-1-15 | V1.0.0 | 创建 | 张雨娇 |  |
| 2 | 2024-3-11 | V2.0.0 | 更改 | 许文杰 |  |
| 3 | 2024-3-11 | V2.0.1 | 更改 | 孟庆利 |  |
| 4 | 2024-3-11 | V2.0.2 | 更改 | 许文杰 |  |

# 一、文档说明
本接口文档主要是获取前置分组结果。提供两个接口，鉴权接口token，主要返回发起前置分组接口所必须的参数access_token。前置分组接口pregrouping,拿到鉴权接口返回的access_token，传送分组所需参数，对接口发起请求，接口返回最终的分组结果。
# 二、接口协议
- 1.接口说明
对外接口以REST service服务方式提供，用http post方法传递json参数，以json返回调用结果，content-type为application/json。

- 2.接口鉴权
1、接口访问者带入提供的appid、appsecret，对token接口发起访问。前置分组接口发起访问之前必须调鉴权接口，拿到access_token才能成功访问。

- 3.参数类型说明
| 序号 | 类型 | 说明 | 格式 | 范例 |
| --- | --- | --- | --- | --- |
| 1 | String(s) | 字符型 | s:代表长度 | “TestFunction”、”测试“ |
| 2 | Integer | 整型 |  | 0、1、100、-1、-100 |
| 3 | Number(p,s) | 数值型 | p:长度；s:小数精度 | 67.4、78.5、89.4 |
| 4 | DateTime | 日期时间型 | YYYY-MM-DDHH24:Mi:SS | “2023-05-0115:45:54” |
| 5 | Date | 日期型 | YYYY-MM-DD | “2023-05-01” |
| 6 | Time | 时间型 | HH24:Mi:SS | ”15:45:54” |
| 7 | Timestamp(s) | 时间戳类型(UTC+8) | s=10:精确到秒；s=13:精确到毫秒； |  |
| 8 | Obj | 结构体 |  |  |

三、业务接口
## 1.获取前置分组结果
### 1.1 鉴权认证接口

| 接口作用描述 | 获取分组接口的access_token值 |
| --- | --- |
| 请求参数格式 | application/json |
| 数据传输方式 | HTTP的POST形式 |
| 测试环境地址 | https://wsbi.succez.com/dip_test/DIP/public/preGroup.action?method=token |
| 正式环境地址 | http://172.16.82.156:8080/DIP/public/preGroup.action?method=token |

- **输入：**

| 序号 | 字段名 | 字段类型 | 上级节点 | 必填 | 名称 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | appid | String |  | 是 | 应用ID | 赛思提供 |
| 2 | appsecret | String |  | 是 | 应用秘钥 | 赛思提供 |

```js
{//直接传递此参数
    "appid": "975aad59868c427ab3041351f431b303", 
    "appsecret": "bc70c00c741345b5bf6b0b66622649e2" 
}
```
- **输出：**

| 序号 | 字段名 | 字段类型 | 上级节点 | 必填 | 名称 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | result | String |  | 是 | 状态码 | success-成功，fail-失败 |
| 2 | data | Obj |  | 是 |  |  |
| 3 | msg | String | data | 否 | 异常信息 | 鉴权异常原因，成功返回空字符串。 |
| 4 | access_token | String | data | 是 |  |  |
| 5 | expires_in | Integer | data | 是 | 有效期 | 例如:1800,单位是秒 |

```js
鉴权成功返回结果如下：
{
    "result": "success",
    "data": {
        "access_token": "EwBmGYEZmBOACSB2AXMSbxA=",
        "msg": "",
        "expires_in": 1800 
    }
}
鉴权失败返回结果如下：
{
    "result": "fail",
    "data": {
        "access_token": "",
        "msg": "系统异常",
         "expires_in": 1800
    }
}

```
### 1.2 前置分组接口

| 接口作用描述 | 获取分组器对病案数据的分组结果 |
| --- | --- |
| 请求参数格式 | application/json |
| 数据传输方式 | HTTP的POST形式 |
| 测试环境地址 | https://wsbi.succez.com/dip_test/DIP/public/preGroup.action?method=preGroup |
| 正式环境地址 | http://172.16.82.156:8080/DIP/public/preGroup.action?method=preGroup |

- 输入

| 序号 | 字段名 | 字段类型 | 上级节点 | 必填 | 名称 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | access_token | String |  | 是 |  | 鉴权返回 |
| 2 | data | Obj |  | 是 |  |  |
| 3 | xm | String(50) | data | 是 | 姓名 |  |
| 4 | zjhm | String(50) | data |  | 证件号码 |  |
| 5 | bah | String(20) | data | 是 | 病案号 |  |
| 6 | nl | String(20) | data |  | 年龄 |  |
| 7 | xb | String(20) | data |  | 性别(男；女) |  |
| 8 | bzyzsnl | Number(10,2) | data |  | 年龄不足1周岁的年龄月 |  |
| 9 | xsecstz | Number(10,2) | data |  | 新生儿出生体重克 |  |
| 10 | xserytz | Number(10,2) | data |  | 新生儿入院体重克 |  |
| 11 | rysj | String(50) | data |  | 入院时间 |  |
| 12 | cysj | String(50) | data |  | 出院时间 |  |
| 13 | sjzyts | Number(10) | data |  | 实际住院天数 |  |
| 14 | ylfkfs | String(50) | data |  | 医疗付款方式 |  |
| 15 | ryzd | String(50) | data |  | 入院诊断编码 |  |
| 16 | ryzd1 | String(50) | data |  | 入院诊断编码1 |  |
| 17 | ryzd2 | String(50) | data |  | 入院诊断编码2 |  |
| 18 | ryzd3 | String(50) | data |  | 入院诊断编码3 |  |
| 19 | ryzd4 | String(50) | data |  | 入院诊断编码4 |  |
| 20 | ryzd5 | String(50) | data |  | 入院诊断编码5 |  |
| 21 | ryzd6 | String(50) | data |  | 入院诊断编码6 |  |
| 22 | ryzd7 | String(50) | data |  | 入院诊断编码7 |  |
| 23 | ryzd8 | String(50) | data |  | 入院诊断编码8 |  |
| 24 | ryzd9 | String(50) | data |  | 入院诊断编码9 |  |
| 25 | ryzd10 | String(50) | data |  | 入院诊断编码10 |  |
| 26 | ryzd11 | String(50) | data |  | 入院诊断编码11 |  |
| 27 | ryzd12 | String(50) | data |  | 入院诊断编码12 |  |
| 28 | ryzd13 | String(50) | data |  | 入院诊断编码13 |  |
| 29 | ryzd14 | String(50) | data |  | 入院诊断编码14 |  |
| 30 | ryzd15 | String(50) | data |  | 入院诊断编码15 |  |
| 31 | zyzd | String(50) | data |  | 主要诊断 |  |
| 32 | qtzd1 | String(50) | data |  | 其他诊断1 |  |
| 33 | qtzd2 | String(50) | data |  | 其他诊断2 |  |
| 34 | qtzd3 | String(50) | data |  | 其他诊断3 |  |
| 35 | qtzd4 | String(50) | data |  | 其他诊断4 |  |
| 36 | qtzd5 | String(50) | data |  | 其他诊断5 |  |
| 37 | qtzd6 | String(50) | data |  | 其他诊断6 |  |
| 38 | qtzd7 | String(50) | data |  | 其他诊断7 |  |
| 39 | qtzd8 | String(50) | data |  | 其他诊断8 |  |
| 40 | qtzd9 | String(50) | data |  | 其他诊断9 |  |
| 41 | qtzd10 | String(50) | data |  | 其他诊断10 |  |
| 42 | qtzd11 | String(50) | data |  | 其他诊断11 |  |
| 43 | qtzd12 | String(50) | data |  | 其他诊断12 |  |
| 44 | qtzd13 | String(50) | data |  | 其他诊断13 |  |
| 45 | qtzd14 | String(50) | data |  | 其他诊断14 |  |
| 46 | qtzd15 | String(50) | data |  | 其他诊断15 |  |
| 47 | sscz1 | String(50) | data |  | 手术及操作编码1 |  |
| 48 | sscz2 | String(50) | data |  | 手术及操作编码2 |  |
| 49 | sscz3 | String(50) | data |  | 手术及操作编码3 |  |
| 50 | sscz4 | String(50) | data |  | 手术及操作编码4 |  |
| 51 | sscz5 | String(50) | data |  | 手术及操作编码5 |  |
| 52 | sscz6 | String(50) | data |  | 手术及操作编码6 |  |
| 53 | sscz7 | String(50) | data |  | 手术及操作编码7 |  |
| 54 | sscz8 | String(50) | data |  | 手术及操作编码8 |  |
| 55 | sscz9 | String(50) | data |  | 手术及操作编码9 |  |
| 56 | sscz10 | String(50) | data |  | 手术及操作编码10 |  |
| 57 | zfy | Number(10,2) | data |  | 医疗总费用 |  |
| 58 | ylfwf | Number(12,2) | data |  | 1.一般医疗服务费 |  |
| 59 | zlczf | Number(12,2) | data |  | 2.一般治疗操作费 |  |
| 60 | hlf | Number(12,2) | data |  | 3.护理费 |  |
| 61 | qtfy | Number(12,2) | data |  | 4.其他费用 |  |
| 62 | blzdf | Number(12,2) | data |  | 5.病理诊断费 |  |
| 63 | syszdf | Number(12,2) | data |  | 6.实验室诊断费 |  |
| 64 | yxxzdf | Number(12,2) | data |  | 7.影像学诊断费 |  |
| 65 | lczdxmf | Number(12,2) | data |  | 8.临床诊断项目费 |  |
| 66 | fsszlxmf | Number(12,2) | data |  | 9.非手术治疗项目费 |  |
| 67 | wlzlf | Number(12,2) | data |  | 其中：临床物理治疗费 |  |
| 68 | sszlf | Number(12,2) | data |  | 10.手术治疗费 |  |
| 69 | maf | Number(12,2) | data |  | 其中：麻醉费 |  |
| 70 | ssf | Number(12,2) | data |  | 其中：手术费 |  |
| 71 | kff | Number(12,2) | data |  | 11.康复费 |  |
| 72 | zyzlf | Number(12,2) | data |  | 12.中医治疗费 |  |
| 73 | xyf | Number(12,2) | data |  | 13.西药费 |  |
| 74 | kjywf | Number(12,2) | data |  | 其中：抗菌药物费 |  |
| 75 | zcyf | Number(12,2) | data |  | 14.中成药费 |  |
| 76 | zcaoyf | Number(12,2) | data |  | 15.中草药费 |  |
| 77 | xf | Number(12,2) | data |  | 16.血费 |  |
| 78 | bdblzpf | Number(12,2) | data |  | 17.白蛋白类制品费 |  |
| 79 | qdblzpf | Number(12,2) | data |  | 18.球蛋白类制品费 |  |
| 80 | nxyzlzpf | Number(12,2) | data |  | 19.凝血因子类制品费 |  |
| 81 | xbyzlzpf | Number(12,2) | data |  | 20.细胞因子类制品费 |  |
| 82 | hcyyclf | Number(12,2) | data |  | 21.检查用一次性医用材料费 |  |
| 83 | yyclf | Number(12,2) | data |  | 22.治疗用一次性医用材料费 |  |
| 84 | ycxyyclf | Number(12,2) | data |  | 23.手术用一次性医用材料费 |  |
| 85 | qtf | Number(12,2) | data |  | 24.其他费 |  |

```js
{
      "access_token": "EwBmGYEZmBOACSB2AXMSbxA=",
      "data": [{
          "xm": "",
        "zjhm": "",
        "bah": "",
        "nl": "",
        "xb": "",
        "bzyzsnl": "",
        "xsecstz": "",
        "xserytz": "",
        "rysj": "",
        "cysj": "",
        "sjzyts": "",
        "ylfkfs": "",
        "ryzd": "",
        "ryzd1": "",
        "ryzd2": "",
        "ryzd3": "",
        "ryzd4": "",
        "ryzd5": "",
        "ryzd6": "",
        "ryzd7": "",
        "ryzd8": "",
        "ryzd9": "",
        "ryzd10": "",
        "ryzd11": "",
        "ryzd12": "",
        "ryzd13": "",
        "ryzd14": "",
        "ryzd15": "",
        "zyzd": "",
        "qtzd1": "",
        "qtzd2": "",
        "qtzd3": "",
        "qtzd4": "",
        "qtzd5": "",
        "qtzd6": "",
        "qtzd7": "",
        "qtzd8": "",
        "qtzd9": "",
        "qtzd10": "",
        "qtzd11": "",
        "qtzd12": "",
        "qtzd13": "",
        "qtzd14": "",
        "qtzd15": "",
        "sscz1": "",
        "sscz2": "",
        "sscz3": "",
        "sscz4": "",
        "sscz5": "",
        "sscz6": "",
        "sscz7": "",
        "sscz8": "",
        "sscz9": "",
        "sscz10": "",
        "zfy": "",
        "ylfwf": "",
        "zlczf": "",
        "hlf": "",
        "qtfy": "",
        "blzdf": "",
        "syszdf": "",
        "yxxzdf": "",
        "lczdxmf": "",
        "fsszlxmf": "",
        "wlzlf": "",
        "sszlf": "",
        "maf": "",
        "ssf": "",
        "kff": "",
        "zyzlf": "",
        "xyf": "",
        "kjywf": "",
        "zcyf": "",
        "zcaoyf": "",
        "xf": "",
        "bdblzpf": "",
        "qdblzpf": "",
        "nxyzlzpf": "",
        "xbyzlzpf": "",
        "hcyyclf": "",
        "yyclf": "",
        "ycxyyclf": "",
        "qtf": ""
      }]
}
```

- 输出

| 序号 | 字段名 | 字段属性 | 上级节点 | 必填 | 名称 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | result | String |  | 是 | 状态码 | success-成功，fail-失败 |
| 2 | data | Obj |  | 是 |  | 具体返回参数待沟通 |
| 3 | msg | String |  | 否 | 分组审核异常信息 | 分组过程。 |
| 4 | url | String | data | 是 | 分组结果查看地址 | 成功返回地址，失败返回空 |

```js
分组成功返回结果如下：
{
result: "success",
         data: {
            url: "分组结果查看地址",
            msg: ""
         }

}
分组失败返回结果如下：
{
result: "fail",
         data: {
            url: "缺少参数",
            msg: ""
         }

}

```