灵医智惠CDSS标准版API开发指南v1——重症监护系统¶
产品功能 | API | method |
---|---|---|
重症监护质控 | 重症监护质控API | cdss-reminder-icu |
患者数据规范¶
{
// 文档基础信息[所有字段必填]
"scene": ["重症监护系统"], // 使用CDSS的场景
"trigger": "保存/提交/CDSS", // 触发CDSS的方式,保存:点击保存时自动触发;提交:点击提交时自动触发;CDSS:点击单独新增的CDSS按钮触发
"uid": "登录重症监护系统的工作人员账号id",
"rid": "住院号",
"pid": "患者号",
"医生": "登录重症监护系统的工作人员姓名",
"医院": "医院名称",
"科室": "科室名称",
"诊疗类型": "急诊/门诊/住院/体检",
"诊疗次数": "",
// 患者关键信息[所有字段必填]
"姓名": "",
"年龄": "xx岁",
"性别": "男/女",
// 患者其他信息[按实际情况选填]
"费用类型": "商保/医保/自费",
"身高": "",
"体重": "",
"出生日期": "1983-05-12",
"职业": "",
// 体温单
"体温单": {
"体温": [ // T
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"},
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"脉搏": [ // P
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"心率": [ // HR
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"呼吸": [ // R
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"收缩压": [
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"舒张压": [
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"血氧": [ // SpO2
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"尿量": [
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"体重": [
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"中心静脉压": [ // CVP
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"心排血量": [ // CO
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
],
"脑电双频指数": [ // BIS
{"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
]
}
}
重症监护质控功能¶
重症监护质控API¶
- API Protocol:
HTTP
- HTTP Server:
http://01cdss.baidu.com
- Request Path:
/cdss/standard/api/v1
- Request Headers:
Authorization: 按照文档生成的签名
《API接口认证指南》 - Request Method:
POST
- Content-Type:
application/json; charset=utf-8
- Request Body
??? note "请点击箭头查看内容 (method = cdss-reminder-icu)"
> **[warning] 注意**
>
> 此处emr格式只有部分字段,仅用于示例,不是完整定义,emr的详细定义请严格遵守《患者数据规范》
```json
{
"method": "cdss-reminder-icu",
"emr": {
"场景": ["重症监护系统"],
"trigger": "保存/提交/CDSS",
"医院": "",
"科室": "",
"医生": "",
"uid": "",
"rid": "",
"pid": "",
"年龄": "28岁",
"性别": "男/女",
"诊疗类型": "急诊/门诊/住院/体检",
"体温单": [
{
... // 完整定义请严格遵守《患者数据规范》
}
]
}
}
```
- Response
??? note "请点击箭头查看内容"
```json
{
"code": 0,
"message": "",
"result": [
{
"level": "notice/warning/error", // 提醒级别
"type": "重症监护", // 提醒类型
"message": "" // 提醒详细内容
}
]
}
```
错误码定义¶
code | 错误类别 | 含义 |
---|---|---|
0 | 正常 | 正常 |
1xxxx | 语法错误 | 请求URI错误、参数缺失、参数格式错误 |
2xxxx | 权限错误 | 鉴权失败、流量超过限制等 |
3xxxx | 网络错误 | 某个网络服务出现连接失败、请求超时等 |
4xxxx | 内部错误 | 内部异常、数据异常等 |
code | 含义 |
---|---|
0 | 正常(返回结果可能为空) |
10100 | method不存在 |
10200 | 请求参数异常,请仔细对照文档检查请求数据格式 |
20100 | license过期,请联系灵医智惠CDSS商务人员重新申请 |
20200 | 权限异常,无权访问该资源 |
20300 | 异常流量 |
30100 | 服务连接异常,一般是某个依赖服务连接失败 |
30200 | 服务超时,请重试或者减少单次检索的数据量 |
40100 | 服务数据异常,内部错误 |
40200 | 代码抛异常 |
40300 | 未知异常 |
40400 | 初始化异常,启动失败 |
40500 | 配置异常,请检查配置文件 |
40600 | 不支持的资源 |
注意事项¶
1.code不为0时表示接口异常,对接时可做好日志记录,无需在系统中弹出错误信息,影响就诊流程。 2.调用CDSS系统时,无论是否请求成功,做好异常处理(设置请求超时时间,建议3秒),保证医院就诊业务正常运行。