灵医智惠CDSS标准版API开发指南v2——护理系统¶

产品功能	API	method
医嘱执行质控（非标本）	医嘱执行质控API（非标本）	cdss-reminder-nurse
医嘱执行质控（带标本）	医嘱执行质控API（带标本）	cdss-reminder-lis
护理措施	护理措施提示API	cdss-reminder-clinic-event

医嘱执行质控（非标本）¶

医嘱执行质控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-nurse)

{
  "method": "cdss-reminder-nurse",
  "emr": {
    "场景": ["医嘱"],
    "trigger": "提交",   // 触发CDSS的方式                        
    "工作人员信息": {
      "医院": "",               // [必填]医院名称
      "科室": "",               // [必填]科室名称
      "姓名": "",               // [必填]工作人员姓名
      "账号ID": "",             // [必填]医疗信息系统账号
      "角色": "医生/护士/药师/等",
      "职称": "",
      "ip": ""                  //  医生电脑ip地址
    },
    "患者信息": {
      "就诊类型": "门诊/住院/急诊/体检",      // [必填]
      "就诊次数": "",          // "1":初诊，大于1表示复诊
      "就诊ID": "",            // [必填] 住院号 或者 门诊号
      "患者ID": "",            // [必填]
      "年龄": "28岁",          // [必填] xx岁/xx月/xx天/xx小时
      "性别": "男/女",         // [必填] 
      "出生日期": "",          // yyyy-MM-dd
      "职业": "",
      "出生地": "",
      "现住地": "",
      "费用类型": "医保/商保/自费/公费/等",
      "身高": "180cm",
      "体重": "70kg",
      "ABO血型": "A/B/AB/O",
      "Rh血型": "阴/阳",
      "婚姻状态": "未婚/已婚/离异/丧偶"
    },
    "医嘱": [
      {                                       // 医嘱执行记录, 同一条医嘱多次执行拆成多条医嘱（医嘱ID相同，执行时间不同）
        "医嘱ID": "",                         // [必填] 医嘱单号
        "医嘱分组": "",                       // 可以代表医嘱分组的信息即可，比如父医嘱名、父医嘱序号、父医嘱ID
        "医嘱类型": "用药",          // [必填] 
        "医嘱项目": "",                       // [必填] 
        "长期或临时": "长期/临时",             // [必填] 
        "医嘱状态": "执行",                   // [必填] 
        "执行时间": "yyyy-MM-dd HH:mm:ss",    // [必填] 医嘱实际执行的时间
        "医嘱执行科室": "",
        "医嘱执行者": "",
        "皮试结果": ""                        // 皮试结果
      }
    ]
  }
}

Response

请点击箭头查看内容

{
  "code": 0,
  "message": "",
  "result": [
    {
      "level": "notice/warning/error",  // 提醒级别
      "type": "护理",                   // 提醒类型
      "message": ""                     // 提醒详细内容
    }
  ]
}

医嘱执行质控（带标本）¶

医嘱执行质控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-lis)

{
  "method": "cdss-reminder-lis",
  "emr": {
    "场景": ["检验标本采集"],
    "工作人员信息": {
      "医院": "",               // [必填]医院名称
      "科室": "",               // [必填]科室名称
      "姓名": "",               // [必填]工作人员姓名
      "账号ID": "",             // [必填]医疗信息系统账号
      "角色": "医生/护士/药师/等",
      "职称": "",
      "ip": ""                  //  医生电脑ip地址
    },
    "患者信息": {
      "就诊类型": "门诊/住院/急诊/体检",      // [必填]
      "就诊次数": "",           // "1":初诊，大于1表示复诊
      "就诊ID": "",            // [必填] 住院号 或者 门诊号
      "患者ID": "",            // [必填]
      "年龄": "28岁",          // [必填] xx岁/xx月/xx天/xx小时
      "性别": "男/女",         // [必填]
      "出生日期": "",          // yyyy-MM-dd
      "职业": "",
      "出生地": "",
      "现住地": "",
      "费用类型": "医保/商保/自费/公费/等",
      "身高": "180cm",
      "体重": "70kg",
      "ABO血型": "A/B/AB/O",
      "Rh血型": "阴/阳",
      "婚姻状态": "未婚/已婚/离异/丧偶"
    },
    "检验报告": [
      {
        "科室": "",             // 检验科室
        "医嘱ID": "",           // 医嘱申请单ID
        "标本类型": "",          // [必填] 标本类型，比如血清、尿等
        "标本号": "",
        "申请时间": "yyyy-MM-dd HH:mm:ss",
        "预约时间": "yyyy-MM-dd HH:mm:ss",
        "采样时间": "yyyy-MM-dd HH:mm:ss",          // [必填] 检验采样时间
        "检验项目": ""          // [必填] 检验项目（大项）        
      }
    ]
  }
}

Response

请点击箭头查看内容

{
  "code": 0,
  "message": "",
  "result": [
    {
      "level": "notice/warning/error",  // 提醒级别
      "type": "逻辑/检验/检查/手术/治疗", // 提醒类型
      "message": ""                     // 提醒详细内容
    }
  ]
}

护理措施¶

护理措施提示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-clinic-event)

{
  "method": "cdss-reminder-clinic-event",
  "emr": {
    "场景": ["体温单"],
    "trigger": "提交",   // 触发CDSS的方式                        
    "工作人员信息": {
      "医院": "",               // [必填]医院名称
      "科室": "",               // [必填]科室名称
      "姓名": "",               // [必填]工作人员姓名
      "账号ID": "",             // [必填]医疗信息系统账号
      "角色": "医生/护士/药师/等",
      "职称": "",
      "ip": ""                  //  医生电脑ip地址
    },
    "患者信息": {
      "就诊类型": "门诊/住院/急诊/体检",      // [必填]
      "就诊次数": "",          // "1":初诊，大于1表示复诊
      "就诊ID": "",            // [必填] 住院号 或者 门诊号
      "患者ID": "",            // [必填]
      "年龄": "28岁",          // [必填] xx岁/xx月/xx天/xx小时
      "性别": "男/女",         // [必填] 
      "出生日期": "",          // yyyy-MM-dd
      "职业": "",
      "出生地": "",
      "现住地": "",
      "费用类型": "医保/商保/自费/公费/等",
      "身高": "180cm",
      "体重": "70kg",
      "ABO血型": "A/B/AB/O",
      "Rh血型": "阴/阳",
      "婚姻状态": "未婚/已婚/离异/丧偶"
    },
    "体温单": [
      {
        "体温": [             // T
          {"值": "", "单位":"℃", "时间": "yyyy-MM-dd HH:mm:ss"},
          {"值": "", "单位":"℃", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "脉搏": [           // P
          {"值": "", "单位":"bpm", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "心率": [           // HR
          {"值": "", "单位":"次/分", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "呼吸": [           // R
          {"值": "", "单位":"次/分", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "收缩压": [
          {"值": "", "单位":"mmHg", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "舒张压": [
          {"值": "", "单位":"mmHg", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "血氧": [          // SpO2
          {"值": "", "单位":"%", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "尿量": [
          {"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
        ],
        "体重": [
          {"值": "", "单位":"kg", "时间": "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"}
        ],
        "血糖": [   
          {"值": "", "单位":"", "时间": "yyyy-MM-dd HH:mm:ss"}
        ]
      }
    ]
  }
}

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