灵医智惠CDSS标准版API开发指南v1——手术麻醉系统¶

产品功能	API	method
手术风险质控	手术风险质控API	cdss-reminder-operation

患者数据规范¶

{
  // 文档基础信息[所有字段必填]
  "scene": ["手术麻醉系统"],   // 使用CDSS的场景
  "trigger": "保存/提交/CDSS",   // 触发CDSS的方式，保存：点击保存时自动触发；提交：点击提交时自动触发；CDSS：点击单独新增的CDSS按钮触发
  "uid": "登录手术麻醉系统的工作人员账号id",
  "rid": "住院号",
  "pid": "患者号",
  "医生": "登录手术麻醉系统的工作人员姓名",
  "医院": "医院名称",
  "科室": "科室名称",
  "诊疗类型": "住院",
  "诊疗次数": "",

  // 患者关键信息[所有字段必填]
  "姓名": "",
  "年龄": "xx岁",
  "性别": "男/女",
  // 患者其他信息[按实际情况选填]
  "费用类型": "商保/医保/自费",
  "身高": "",
  "体重": "",
  "出生日期": "1983-05-12",
  "职业": "",

  // 手术申请单
  "手术申请单": [
    {
      "记录ID": "",               // 手术申请单ID
      "记录时间": "",             // 格式为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-operation)"

> **[warning] 注意**
  >
  > 此处emr格式只有部分字段，仅用于示例，不是完整定义，emr的详细定义请严格遵守《患者数据规范》

  ```json
  {
    "method": "cdss-reminder-operation",
    "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秒），保证医院就诊业务正常运行。