灵医智惠CDSS标准版API开发指南v2——血液透析系统¶

产品功能	API	method
血液透析质控	血液透析质控API	cdss-reminder-hd

患者数据规范¶

{
  "场景": ["血液透析申请单"],
  "trigger": "保存/提交/CDSS",   // 触发CDSS的方式
                                //  1) 保存：点击保存时自动触发；
                                //  2) 提交：点击提交时自动触发；
                                //  3) CDSS：点击单独新增的CDSS按钮触发。

  "工作人员信息": {
    "医院": "",               // [必填]医院名称
    "科室": "",               // [必填]科室名称
    "姓名": "",               // [必填]工作人员姓名
    "账号ID": "",             // [必填]医疗信息系统账号
    "角色": "医生/护士/药师/等",
    "职称": "",
    "ip": ""                  //  医生电脑ip地址
  },
  "患者信息": {
    "就诊类型": "门诊/住院/急诊/体检",      // [必填]
    "就诊次数": "",           // "1":初诊，大于1表示复诊
    "就诊ID": "",            // [必填] 住院号 或者 门诊号(一次就诊有唯一ID)
    "患者ID": "",            // [必填] (一个患者有唯一ID)
    "年龄": "28岁",          // [必填] xx岁/xx月/xx天/xx小时
    "性别": "男/女",         // [必填]
    "出生日期": "",          // yyyy-MM-dd
    "职业": "",
    "出生地": "",
    "现住地": "",
    "费用类型": "医保/商保/自费/公费/等",
    "ABO血型": "A/B/AB/O",
    "Rh血型": "阴/阳",
    "婚姻状态": "未婚/已婚/离异/丧偶"
  },
  "血液透析申请单": [
    {
      "记录ID": "",                           // [必填]
      "记录时间": "yyyy-MM-dd HH:mm:ss",
      "透析时间": "yyyy-MM-dd HH:mm:ss",
      "称量体重": "75kg",
      "净体重": "75kg",
      "干体重": "75kg",
      "舒张压": "90mmHg",
      "收缩压": "120mmHg",
      "心率": "70次/分钟"
    }
  ]
}

血液透析质控功能¶

血液透析质控API¶

API Protocol: HTTP
HTTP Server: https://ihcloud-sandbox.baidu.com
Request Path: /cdss/standard/api/v2
Request Headers: Authorization: 按照文档生成的签名 《API接口认证指南》
Request Method: POST
Content-Type: application/json; charset=utf-8
Request Body

请点击箭头查看内容 (method = cdss-reminder-hd)

[warning] 注意

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

  {
    "method": "cdss-reminder-hd",
    "emr": {
      "场景": ["血液透析申请单"],
      "trigger": "保存/提交/CDSS",
      "工作人员信息": {
        "医院": "",
        "科室": "",
        ...   // 完整定义请严格遵守《患者数据规范》
      },
      "患者信息": {
        "就诊类型": "住院",
        "就诊ID": "",
        "患者ID": "",
        "年龄": "28岁",
        "性别": "男/女",
        ...   // 完整定义请严格遵守《患者数据规范》
      },
      "血液透析申请单": [
        {
          ...   // 完整定义请严格遵守《患者数据规范》
        }
      ]
    }
  }

Response

请点击箭头查看内容

  {
    "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秒），保证医院就诊业务正常运行。