灵医智惠CDSS标准版API开发指南v1——LIS系统¶

产品功能	API	method
检验项目质控	检验项目质控API	cdss-reminder-lis
检验结果解读	检验结果解读API	cdss-analysis-lis

患者数据规范¶

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

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

  // 检验报告单
  "检验": [
    {
      "申请时间": "yyyy-MM-dd HH:mm:ss",
      "采样时间": "yyyy-MM-dd HH:mm:ss",
      "收样时间": "yyyy-MM-dd HH:mm:ss",
      "检验时间": "yyyy-MM-dd HH:mm:ss",
      "报告时间": "yyyy-MM-dd HH:mm:ss",
      "标本类型": "血/血清/尿/等",
      "检验项": "",               // 检验小项名称，比如白细胞计数
      "检验项ID": "",             // 检验小项ID
      "检验类型": "",             // 检验大项名称，比如血常规
      "检验单号": "",             // 检验大项ID
      "医嘱单号": "",             // 医嘱申请单单号
      "检验结果": "正常/偏高/偏低/阳/阴/等", // 结果明确的填具体值，不明确留空
      "检验值": {
        "值": 8.5,
        "单位": "10^9个/L"
      },
      "最小值": {
        "值": 5.0,
        "单位": "10^9个/L"
      },
      "最大值": {
        "值": 10.0,
        "单位": "10^9个/L"
      },
      "正常值": "阴性"
    }
  ]
}

检验项目质控功能¶

检验项目质控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-lis)"

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

  ```json
  {
    "method": "cdss-reminder-lis",
    "emr": {
      "场景": ["检验标本签收","检验报告审核","查看检验报告"],
      "trigger": "保存/提交/CDSS",
      "医院": "",
      "科室": "",
      "医生": "",
      "uid": "",
      "rid": "",
      "pid": "",
      "年龄": "28岁",
      "性别": "男/女",
      "诊疗类型": "急诊/门诊/住院/体检",
      "检验": [
        {
          "检验单号": "",
          "医嘱单号": "",        // 医嘱申请单单号
          "检验项": "",         // 检验小项，比如白细胞计数
          "检验类型": "",       // 检验大项，比如血常规
          ...   // 完整定义请严格遵守《患者数据规范》
        }
      ]
    }
  }
  ```

Response

??? note "请点击箭头查看内容"

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

检验结果解读功能¶

检验结果解读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-analysis-lis)"

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

  ```json
  {
    "method": "cdss-analysis-lis",
    "emr": {
      "场景": ["检验系统"],
      "trigger": "保存/提交/CDSS",
      "医院": "",
      "科室": "",
      "医生": "",
      "uid": "",
      "rid": "",
      "pid": "",
      "年龄": "28岁",
      "性别": "男/女",
      "诊疗类型": "急诊/门诊/住院/体检",
      "检验": [
        {
          "检验单号": "",
          "医嘱单号": "",        // 医嘱申请单单号
          "检验项": "",         // 检验小项，比如白细胞计数
          "检验类型": "",       // 检验大项，比如血常规
          ...   // 完整定义请严格遵守《患者数据规范》
        }
      ]
    }
  }
  ```

Response

??? note "请点击箭头查看内容"

```json
  {
    "code": 0,
    "message": "",
    "result": [
      {
        "name": "白细胞计数",                // 检验指标项
        "message": "白细胞计数偏高，可能xxx"   // 解读结果
      }
    ]
  }
  ```

错误码定义¶

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