灵医智惠CDSS标准版API开发指南v2——HIS/EMR系统¶

产品功能	API	method
医嘱质控	医嘱质控API	cdss-reminder-emr
	强制通过理由提交API	cdss-action-emr
疑似诊断推荐	疑似诊断推荐API	cdss-diagnose
	疑似诊断推荐理由详情API	cdss-detail-diagnose
	鉴别诊断推荐API	cdss-ddx
治疗方案推荐	治疗方案推荐API	cdss-treat
	检查结果治疗方案推荐API	cdss-treat-ris
知识库	知识库检索API	cdss-kb-search
	知识库详情API	cdss-kb-detail-new
相似病历	相似病历推荐API	cdss-emr-similar
	病历检索API	cdss-emr-search
	病历详情API	cdss-detail-emr

患者数据规范¶

医嘱可以和门诊记录/入院记录支持同时提交，也支持分开提交。

门诊记录¶

{
  "场景": ["门诊记录"],
  "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
    "职业": "",
    "民族": "",
    "出生地": "",
    "现住地": "",
    "费用类型": "医保/商保/自费/公费/等",
    "身高": "180cm",
    "体重": "70kg",
    "ABO血型": "A/B/AB/O",
    "Rh血型": "阴/阳",
    "婚姻状态": "未婚/已婚/离异/丧偶",
    "特殊人群": [""],
    "生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
  },
  "门诊记录": {
    "是否复诊": "",         //是/否
    "科室": "",            // 门诊科室
    "记录ID": "",          // 门诊记录ID
    "记录内容": "",     // 无结构化纯文本内容, 仅用于无法提供结构化数据的厂商使用
    "记录时间": "yyyy-MM-dd HH:mm:ss",         // 门诊记录书写时间
    "就诊时间": "yyyy-MM-dd HH:mm:ss",         // 患者就诊时间
    "怀孕状态": "未孕/已孕/已育",
    "主诉": "",
    "现病史": "",
    "既往史": "",
    "个人史": "",
    "月经史": "",
    "婚育史": "",
    "家族史": "",
    "过敏史": "",
    "接种史": "",
    "体格检查": "",
    "辅助检查": "",
    "专科检查": "",
    "嘱咐": "",              // 医生对患者建议的注意事项
    "诊断": [
      {
        "诊断类型": "初步诊断/补充诊断/确诊诊断/其他诊断/门诊诊断",
        "诊断项": "",
        "主要诊断": "是/否",
        "诊断ICD编码": ""
      }
    ],
    "中医诊断": [
      {
        "诊断类型": "初步诊断/补充诊断/确诊诊断/其他诊断/门诊诊断",
        "主要诊断": "是/否",   
        "中医疾病" : {                  
          "名称": "",
          "代码": ""
        },
        "中医证型": [
          {
            "名称": "",
            "代码": ""
          }
        ]
      }
    ]
  }
}

入院记录¶

{
  "场景": ["入院记录"],
  "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
    "职业": "",
    "民族": "",
    "出生地": "",
    "现住地": "",
    "费用类型": "医保/商保/自费/公费/等",
    "身高": "180cm",
    "体重": "70kg",
    "ABO血型": "A/B/AB/O",
    "Rh血型": "阴/阳",
    "婚姻状态": "未婚/已婚/离异/丧偶",
    "特殊人群": [""],
    "生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
  },
  "入院记录": {
    "科室": "",            // 入院科室
    "记录ID": "",          // 入院记录ID
    "记录内容": "",     // 无结构化纯文本内容, 仅用于无法提供结构化数据的厂商使用
    "记录时间": "yyyy-MM-dd HH:mm:ss",         // 入院记录书写时间
    "入院时间": "yyyy-MM-dd HH:mm:ss",         // 患者入院时间
    "怀孕状态": "未孕/已孕/已育",
    "病史陈述者": "",
    "主诉": "",
    "现病史": "",
    "既往史": "",
    "个人史": "",
    "月经史": "",
    "婚育史": "",
    "家族史": "",
    "过敏史": "",
    "接种史": "",
    "体格检查": "",
    "辅助检查": "",
    "专科检查": "",
    "诊断": [
      {
        "诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断/鉴别诊断",
        "诊断项": "",
        "主要诊断": "是/否",
        "诊断ICD编码": ""
      }
    ],
    "中医诊断": [
      {
        "诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断/鉴别诊断",
        "主要诊断": "是/否",   
        "中医疾病" : {                  
          "名称": "",
          "代码": ""
        },
        "中医证型": [
          {
            "名称": "",
            "代码": ""
          }
        ]
      }
    ]
  }
}

医嘱¶

{
  "场景": ["医嘱"],
  "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
    "职业": "",
    "出生地": "",
    "现住地": "",
    "费用类型": "医保/商保/自费/公费/等",
    "身高": "180cm",
    "体重": "70kg",
    "ABO血型": "A/B/AB/O",
    "Rh血型": "阴/阳",
    "婚姻状态": "未婚/已婚/离异/丧偶",
    "特殊人群": [""],
    "生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
  },
  "医嘱": [
    {
      "处方ID": "",                              // 处方号
      "医嘱ID": "",                              // [必填] 医嘱项目的唯一ID，一个门诊处方下的药品之间医嘱ID不同，处方ID相同，请注意：医嘱ID是全局唯一的，不是医嘱项目院内编码
      "医嘱分组": "",                            // 可以代表医嘱分组的信息即可，比如父医嘱名、父医嘱序号、父医嘱ID
      "医嘱类型": "用药/检验/检查/诊疗/手术/护理/出院带药/材料",  // [必填] 
      "医嘱项目": "",                            // [必填] 
      "长期或临时": "长期/临时",                   // [必填] 
      "医嘱状态": "新开/执行/停止/取消",            // [必填] 
      "录入时间": "yyyy-MM-dd HH:mm:ss",         // 医嘱开立时间
      "审核时间": "yyyy-MM-dd HH:mm:ss",         // 医嘱审核时间
      "开始时间": "yyyy-MM-dd HH:mm:ss",         // 医嘱下达的预期开始时间
      "结束时间": "yyyy-MM-dd HH:mm:ss",         // 医嘱下达的预期结束时间
      "医嘱开立科室": "",
      "医嘱开立者": "",
      "医嘱审核科室": "",
      "医嘱审核者": "",

      //以下为检验医嘱独有字段
      "标本":"",

      // 以下为用药医嘱独有字段
      "用药天数":"", 
      "药物商品名": "",                          // 医嘱类型=用药时 [必填]
      "药物通用名": "",
      "国药准字号": "",                          // 医嘱类型=用药时 [必填] 
      "药物编码": "",
      "药物类别": "电解质平衡调节药",
      "药物剂型": "注射剂/片剂/胶囊剂/丸剂/散剂/气雾剂/等",           // 医嘱类型=用药时 [必填]
      "用药途径": "口服/皮下注射/肌肉注射/静脉注射/外用/雾化吸入/等",   // 医嘱类型=用药时 [必填]
      "使用频率": "",                           // 医嘱类型=用药时 [必填]
      "单次剂量": "",                           // 医嘱类型=用药时 [必填]
      "总剂量": "",                             // 医嘱类型=用药时 [必填]
      "剂量单位": "",                           // 医嘱类型=用药时 [必填]
      // 皮试医嘱有2种常见方式: 1)用药医嘱之外单独开一项皮试医嘱；2)开用药医嘱，标记"需要皮试"，护士做完皮试后填写"皮试结果"
      "需要皮试": "是/否",

      // 以下为护理医嘱、诊疗医嘱独有字段
      "执行频率": "",
      "护理级别": "",

      // 以下为检查医嘱、检验医嘱独有字段
      "报告ID": "",                            // 检验报告ID或者检查报告ID

      // 以下为手术医嘱独有字段
      "麻醉方式": "",

      // 以下为检查
      "检查部位": ["胸部","腹部"],
      "检查方法": ["平扫","正推"]
    }  
  ]
}

医嘱质控功能¶

医嘱质控API¶

Warning

ihcloud-sandbox.baidu.com仅用于开发、测试和联调，禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。

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-emr)

[warning] 注意

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

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

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "level": "notice/warning/error",  //提醒级别
        "type": "文书/用药/检验/检查/手术/用血/治疗/血液透析/护理",  // 提醒类型
        "message": "提醒详细内容"
      }
    ]
  }

强制通过理由提交API¶

Warning

ihcloud-sandbox.baidu.com仅用于开发、测试和联调，禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。

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-action-emr)

[warning] 注意

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

  {
    "method": "cdss-action-emr",
    "params": [{
        "pid": "",            //患者id
        "rid": "",            //就诊id
        "advice_id": "",      //医嘱id
        "type": "",           //质控点类型
        "subtype": "",        //质控点子类型
        "level": "",  
        "message": "",        //质控提醒
        "pass_reason": ""     //通过理由
    }],
    "emr": {
        "工作人员信息": {
        "医院": "",
        "科室": "",
        ...   // 完整定义请严格遵守《患者数据规范》
      },
      "患者信息": {
        "就诊类型": "门诊/住院/急诊/体检",
        "就诊ID": "",
        "患者ID": "",
        "年龄": "28岁",
        "性别": "男/女",
        ...   // 完整定义请严格遵守《患者数据规范》
      }
    }
  }

Response

请点击箭头查看内容

  {
    "code": 0,   
    "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-diagnose-portrait)

[warning] 注意

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

  {
    "method": "cdss-diagnose-portrait",
    "emr": {
      "场景": ["门诊记录/入院记录"],
      "trigger": "保存/提交/CDSS",
      "工作人员信息": {
        "医院": "",
        "科室": "",
        ...   // 完整定义请严格遵守《患者数据规范》
      },
      "患者信息": {
        "就诊类型": "门诊/住院/急诊/体检",
        "就诊ID": "",
        "患者ID": "",
        "年龄": "28岁",
        "性别": "男/女",
        ...   // 完整定义请严格遵守《患者数据规范》
      },
      "门诊记录": {
        ...   // 完整定义请严格遵守《患者数据规范》
      },
      "入院记录": {
        ...   // 完整定义请严格遵守《患者数据规范》
      }
    }
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "suspected_diagnose":[
          {
            "kgid": "013",         // CDSS内部诊断id，用于请求治疗方案推荐和鉴别诊断推荐API
            "name": "支气管哮喘",    // 诊断疾病名
            "tag": [""],           // 诊断标签：甲类传染病、甲类传染病、乙类传染病、待查
            "selected": 1,         // 勾选状态
                                  // 0: 未勾选
                                  // 1: 勾选，医生写的诊断默认处于勾选状态
            "hospital_code": "",   // 医院诊断编码，完成术语对照后才会返回该字段
            "detail": 1,           // 1: 该诊断有知识库详情数据，可通过kgid请求“知识库详情API”
                                  // 0: 该诊断没有知识库详情数据
            "expand": 1,           // 1: 该诊断有疑似诊断推荐理由数据，可通过kgid请求“疑似诊断推荐理由API”
                                  // 0: 该诊断没有疑似诊断推荐理由数据
          }
        ],
        "rare_diagnose":[     // 罕见病诊断
          {
            "tag": [], 
            "detail": 1,
            "expand": 1,
            "hospital_code": "",
            "kgid": "",
            "name": "",
            "selected": 1
          }
        ]        
      }
    ]
  }

疑似诊断推荐理由详情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-detail-diagnose)

  {
    "method": "cdss-detail-diagnose",
    "emr": {},   // emr可选，格式同疑似诊断推荐API
                 // 传入emr可以支持诊断理由高亮
                 // 不传emr字段无法高亮与患者病历内容匹配的诊断理由
    "id": ["疑似诊断推荐API结果中的kgid"]
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "fields": ["症状", "体征", "诱因", "检查", "检验", "家族史", "个人史", "病史"],       // fields中字段是动态展现的，并不是所有诊断的推荐理由都有上述字段
        "症状": [
          {
            "name": "",
            "highlight": 1      // 高亮标记，代表患者病历中有该症状
          }
        ],
        "体征": [
          {
            "name": "",
            "highlight": 1
          }
        ],
        "诱因": [
          {
            "name": "",
            "highlight": 1
          }
        ],
        "检查": [
          {
            "name": "",
            "highlight": 1
          }
        ],
        "检验": [
          {
            "name": "",
            "highlight": 1
          }
        ],
        "家族史": [
          {
            "name": "",
            "highlight": 1
            }
        ],
        "个人史": [
          {
            "name": "",
            "highlight": 1
          }
        ]
      }
    ]
  }

鉴别诊断推荐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-ddx)

  {
    "method": "cdss-ddx",
    "id": ["疑似诊断推荐API结果中的kgid"], // 医生已下达诊断时id字段可省略，将医生下达的诊断放在"emr"中即可
    "emr": {}   // emr格式同疑似诊断推荐API
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "诊断": "支气管哮喘",            // request中id对应的诊断名称
        "鉴别诊断": [
          {
            "name": "",               // 鉴别诊断名称
            "kgid": "",               // CDSS内部鉴别诊断id
            "reason": "",             // 推荐理由
            "hospital_code": ""       // 医院鉴别诊断编码
          }
        ]
      }
    ]
  }

治疗方案推荐功能¶

西医治疗方案推荐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-treat-platform)

json { "method": "cdss-treat-platform", "id": ["疑似诊断推荐API结果中的kgid"], // 医生已下达诊断时id字段可省略，将医生下达的诊断放在"emr"中即可 "emr": {} // emr格式同疑似诊断推荐API }

Response

请点击箭头查看内容

  {
    "message": "",
    "code": 0,
    "result": [
      {
        "fields": [ // fields字段表示有推荐结果的项目类型
          "检验检查",
          "手术",
          "单药治疗",
          "联合用药",
          "其它疗法",
          "量表"
        ],
        "手术": [
          {
            "hospital_code": "",  // 院内编码
            "kgid": "",
            "name": "",           // 项目名称
            "type": "",
            "detail": 0           //0：无详情，1：有详情
          }
        ],
        "检验检查": [
          {
            "hospital_code": "",  // 院内编码
            "kgid": "",
            "name": "",
            "type": "检查",      // 项目类别
            "reason": "",        // 推荐理由
            "detail": 1,         //0：无详情，1：有详情
            "roche_tag":"必要",   //["必要","酌情",""]，其中空串对应复诊
            //以下字段为查询指南文献时使用
            "from_diagnosis": [""],          
            "origin":"项目/本院/默认"   //默认：平台内默认自带的通用知识；
                                       //项目：针对当前项目补充的知识；
                                       //本院：院内人员进行上传的知识
          },
          {
            "hospital_code": "",
            "kgid": "",
            "name": "",
            "type": "检验",      
            "reason": "",
            "detail": 0,
            "roche_tag":"酌情",   //["必要","酌情",""]，其中空串对应复诊
            //以下字段为查询指南文献时使用
            "from_diagnosis": [""],          
            "origin":"项目/本院/默认"   //默认：平台内默认自带的通用知识；
                                       //项目：针对当前项目补充的知识；
                                       //本院：院内人员进行上传的知识
          }
        ],
        "单药治疗": [
          { // 层级1：治疗方案，
            "treatment_name": "",         // 方案名称
            "treatment_detail": "",       // 方案详情
            "drug_family": [              // 层级2：药物类别
              {
                "drug_family_name": "", // 类别名称
                "drug_general": [       // 层级3:药物通用信息
                  {
                    "drug_general_name": [ // 层级4：药物通用名
                      {
                        "name": "",          // 药物商品名
                        "type": "药品"
                      }
                    ],
                    "sign": "首选",  // 药物标签
                    "reason": "",    // 药物推荐理由
                    "drug_way": [    // 给药方式
                      {
                        "hospital_code": "",  // 院内编码
                        "kgid": "",                         
                        "name": "",          // 给药方式名称 
                        "type": "给药途径"
                      }
                    ],
                    "dose": "",     // 给药剂量
                    "drug": [ // 层级4：药品信息
                      {
                        "cfda_id": "",                //国药准字
                        "dosage_form": "",            // 药品剂型
                        "hospital_code": "",          //院内编码
                        "kgid": "",                             
                        "manufacturer": "",           //生产厂家
                        "name": "",                   // 商品名
                        "pname": "",                  // 产品名
                        "specification": "",          //规格
                        "detail": 1                   //0：无详情，1：有详情
                      }
                    ]
                  }
                ],
                "drug_family_detail": "",                     //类别说明
                "sign": ""                                    //类别标签
              }
            ],
            "weight": 0
          }
        ],
        "联合用药": [ // 结构同单药治疗
          {
            "treatment_name": "方案",    //方案名称
            "treatment_detail": "",  //方案说明
            "drug_family": [
              {
                "drug_family_name": "",  //用药类别
                "drug_family_detail": "",//类别说明
                "drug_general": [
                  {
                    "drug_general_name": [
                      {
                        "name": "",      //药名名称                                  
                        "type": "药品"
                      }
                    ],
                    "sign": "",      //药物标签
                    "reason": "",    //推荐里有
                    "drug_way": [
                      {
                        "hospital_code": "",  // 院内编码
                        "kgid": "",                               
                        "name": "",          // 给药方式名称 
                        "type": "给药途径"
                      }
                    ],
                    "dose": "",  // 给药剂量
                    "drug": [
                      {
                        "cfda_id": "",                 //国药准字
                        "dosage_form": "",             // 药品剂型
                        "hospital_code": "",           //院内编码
                        "kgid": "",                                      
                        "manufacturer": "",           //生产厂家
                        "name": "",                   // 商品名
                        "pname": "",                  // 产品名
                        "specification": "",          //规格
                        "detail": 1                   //0：无详情，1：有详情
                      }
                    ]
                  }
                ]
              },
              {
                "drug_family_name": "",  //用药类别
                "drug_family_detail": "",//类别说明
                "drug_general": [
                  {
                    "drug_general_name": [
                      {
                        "name": "",      //药名名称                                  
                        "type": "药品"
                      }
                    ],
                    "sign": "",      //药物标签
                    "reason": "",    //推荐里有
                    "drug_way": [
                      {
                        "hospital_code": "",  // 院内编码
                        "kgid": "",
                        "name": "",          // 给药方式名称 
                        "type": "给药途径"
                      }
                    ],
                    "dose": "",  // 给药剂量
                    "drug": [
                      {
                        "cfda_id": "",                 //国药准字
                        "dosage_form": "",             // 药品剂型
                        "hospital_code": "",           //院内编码
                        "kgid": "",                                          
                        "manufacturer": "",           //生产厂家
                        "name": "",                   // 商品名
                        "pname": "",                  // 产品名
                        "specification": "",          //规格
                        "detail": 1                   //0：无详情，1：有详情
                      }
                    ]
                  }
                ]
              }
            ],
            "weight": 0,            //权重
            "treatment_sign": ""    //类别标签
          }
        ],
        "其它疗法": [
          {
            "hospital_code": "",  //院内编码
            "kgid": "",
            "name": "",           //项目名称
            "type": "治疗",
            "detail": 0           //1:有详情，0：无详情
          }
        ],
        "量表": [
          {
            "name": "",               // 量表名称
            "kgid": "",               // CDSS内部量表id
            "type": "检查",            // 推荐类型，冗余字段
            "reason": "",             // 推荐理由
            "table_url": ""           // 量表网页地址
          }
        ]
      }
    ]
  }

检查结果治疗方案推荐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-treat-ris)

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

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "fields": ["检查", "检验", "药物", "手术", "量表"],   // 推荐类型有序列表
        "检查": [
          {
            "name": "",               // 检查项目名称
            "kgid": "",               // CDSS内部检查项目id
            "type": "检查",            // 推荐类型，冗余字段
            "reason": "",             // 推荐理由
            "selected": 0,            // 勾选状态
            "hospital_code": ""       // 医院检查项目编码
          }
        ],
        "检验": [
          {
            "name": "",               // 检验项目名称
            "kgid": "",               // CDSS内部检验项目id
            "type": "检验",            // 推荐类型，冗余字段
            "reason": "",             // 推荐理由
            "selected": 0,            // 勾选状态
            "hospital_code": ""       // 医院检验项目编码
          }
        ],
        "药物": [
          {
            "name": "",               // 药物名称
            "kgid": "",               // CDSS内部药物id
            "type": "药物",            // 推荐类型，冗余字段
            "reason": "",             // 推荐理由
            "selected": 0,            // 勾选状态
            "hospital_code": ""       // 医院药物编码
          }
        ],
        "手术": [
          {
            "name": "",               // 手术名称
            "kgid": "",               // CDSS内部手术id
            "type": "手术",            // 推荐类型，冗余字段
            "reason": "",             // 推荐理由
            "selected": 0,            // 勾选状态
            "hospital_code": ""       // 医院手术编码
          }
        ],
        "量表": [
          {
            "name": "",               // 量表名称
            "kgid": "",               // CDSS内部量表id
            "type": "检查",            // 推荐类型，冗余字段
            "reason": "",             // 推荐理由
            "table_url": ""           // 量表网页地址
          }
        ]
      }
    ]
  }

中医治疗方案推荐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-tcm)

  {
    "method": "cdss-tcm",
    "emr": {}                  // emr格式同疑似诊断推荐API
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
        {
            "doctor_diagnose" : {  
                "diagonsis":[
                    {
                        "诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断",
                        "诊断项": "",                             // 原始诊断文本
                        "主要诊断": "是/否"
                    }
                ],
                "tcm_diagonsis":[
                    {
                        "诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断/鉴别诊断",
                        "主要诊断": "是/否",                      // 其他诊断按照诊断先后顺序1、2、3显示
                        "中医疾病" : {                            // 病和证是一体的,一个病可以有多个证，一个证可以对应多个病
                            "名称": "",
                            "代码": ""
                        },
                        "中医证型": [
                          {
                            "名称": "",
                            "代码": ""
                          }
                        ]
                    }
                ]
            },
            "tcm_treatment": {                                 //中医治疗方案推荐
                "field":["辨证论治", "特色疗法", "护理调摄"],
                "辨证论治":[{                                   //可能有多个，但是治法一定相同
                    "治法": [
                      {
                          "name":"",   
                          "hospital_id":"",  
                          "hospital_code":"",
                          "kgid":""
                      }
                    ],
                    "方药": [
                        {
                            "evidence_source": "",      // V2.3标准版新增 证据来源文本
                            "detail": 1,
                            "rw_id":"",
                            "kgid":"",
                            "name": "",                        // 方剂名称
                            "expand": 1,
                            "details": [
                                {
                                    "medicine":{
                                        "name":"",             // 中药名
                                        "hospital_id":"",
                                        "hospital_code":"",    //本地化字段
                                        "kgid":""
                                    },
                                    "value":"",                // 数量
                                    "unit":"",                 // 单位
                                    "decoction":{
                                        "name":"",             // 煎制法
                                        "hospital_id":"",
                                        "hospital_code":"",    //本地化字段
                                        "kgid":""
                                    }
                                }
                            ]
                         },
                        {}
                     ]
                }],
                "特色疗法":[
                    {
                        "hospital_id":"",     //机构名称 
                        "hospital_code":"",   //院内编码 
                        "kgid":"",           
                        "name":"",            //疗法名称
                        "reason": ""          //推荐理由
                    }
                ],
                "护理调摄": ""
            }
        }
    ]
  }

知识库功能¶

知识库检索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-kb-search)

  {
    "method": "cdss-kb-search",
    "query": "gxy",
    "params": [
      {
        "type": ["疾病", "药品", "检查", "检验", "手术", "量表", "文献", "指南","护理", "治疗", "法律法规", "中药", "方剂", "经络", "穴位", "中医疾病"],
        "hospital": "",   // 医院，非必传，未传时bi无法统计至医院
        "rid": "",        // 就诊id，非必传，未传时bi无法统计至就诊
        "pid": "",        // 患者id，非必传，未传时bi无法统计至患者
        "doctor": "",     // 医生，非必传，未传时bi无法统计至医生
        "department": "", // 科室，非必传，未传时bi无法统计至科室
        //以下字段为推荐检查检验项目查看文献指南独有字段（根据推荐字段传入，与推荐返回保持一致即可）
        "from_diagnosis": [""],          
        "origin":"项目/本院/默认"   //默认：平台内默认自带的通用知识；
                                   //项目：针对当前项目补充的知识；
                                   //本院：院内人员进行上传的知识
      }
    ]
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "name": "高血压",
        "type": "疾病",
        "id": "疾病ID",
        "source": "elsevier"     //知识来源：elsevier,人卫,cdss_dashboard(院内维护)知识库
      },
      {
        "name": "阿司匹林",
        "type": "药品",
        "id": "药品ID",
        "source": "人卫"
      },
      {
        "name": "",
        "type": "量表",
        "id": "量表ID",
        "url": "量表网页地址",
        "source": "人卫"
      }
    ]
  }

知识库详情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-kb-detail-new)

  {
    "method": "cdss-kb-detail-new",
    // id来源1: 知识库检索API结果中的id
    // id来源2: 治疗方案推荐API结果中的检查/检验/手术的kgid
    // id来源3: 疑似诊断推荐API结果中的疾病的kgid
    "id": [""],
    "params":[
      {
        "hospital": "",    // 医院，非必传，未传时bi无法统计至医院
        "rid": "",         // 就诊id，非必传，未传时bi无法统计至就诊
        "pid": "",         // 患者id，非必传，未传时bi无法统计至患者
        "doctor": "",      // 医生，非必传，未传时bi无法统计至医生
        "department": "",  // 科室，非必传，未传时bi无法统计至科室
        "type": "",        // 知识类型，非必传
        //部署多个知识库时使用，当字段为空时会展示默认知识库
        //如果场景为检索接口打开知识详情，则取检索接口返回中source字段
        "source_type":"elsevier/人卫/cdss_dashboard/KG"   //1.elsevier:爱思唯尔知识库   
                                                          //2.人卫:人卫知识库
                                                          //3.cdss_dashboard:平台维护知识库 
                                                          //4.KG:cdss内置知识
      }
    ]
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "name": "高血压",
        "type": "疾病",
        "url": "疾病知识网页地址"
      },
      {
        "name": "阿司匹林",
        "type": "药品",
        "url": "药品说明书网页地址"
      }
    ]
  }

药品说明书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-kb-detail-cfda)

  {
    "method": "cdss-kb-detail-cfda",
    "cfdaid": "国药准字号"
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "name": "阿司匹林",
        "type": "药品",
        "url": "药品说明书网页地址"
      }
    ]
  }

相似病历功能¶

相似病历推荐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-emr-similar)

  {
    "method": "cdss-emr-similar",
    "emr": {},              // emr格式请严格遵守《患者数据规范》中的门诊记录或入院记录
    "params": [
      {
        "page": 1,          // 翻页参数，第几页
        "pageSize": 10      // 翻页参数，每页结果数量
      }
    ]
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "id": "00003",
        "date": "2018-01-12",
        "诊疗类型": "门诊/住院",
        "年龄": "67岁",
        "性别": "男",
        "科室": "呼吸内科",
        "fields": [       // 展现字段有序列表，根据病历类型动态调整
          "主诉",
          "现病史",
          "初步诊断/入院诊断/确诊诊断/出院诊断"
        ],
        "主诉": "",
        "现病史": "",
        "出院诊断": "",
        "检索诊断": ""      // 最后确诊的主要诊断，可以用作标题展现
      }
    ],
    "extra": {
      "totalNum": 100       // 符合条件的病历结果总数，用于计算翻页总页数
    }
  }

病历检索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-emr-search)

  {
    "method": "cdss-emr-search",
    "query": "咳嗽，胸闷3个月",
    "params": [
      {
        "page": 1,          // 翻页参数，第几页
        "pageSize": 10,     // 翻页参数，每页结果数量
        "date": ["2015-01-01", "2018-12-01"],   // 指定时间范围检索病历
        "age": ["20", "50"],    // 指定年龄范围检索病历
        "department": "呼吸内科",   // 指定科室检索病历
        "sex": "女"   // 指定性别检索病历
      }
    ]
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "id": "00003",
        "date": "2018-01-12",
        "cdr_url": "",
        "诊疗类型": "门诊/住院",
        "年龄": "67岁",
        "性别": "男",
        "科室": "呼吸内科",
        "fields": [       // 展现字段有序列表，根据病历类型动态调整
          "主诉",
          "现病史"
        ],
        "主诉": "",
        "现病史": "",
        "检索诊断": ""      // 最后确诊的主要诊断，可以用作标题展现
      }
    ],
    "extra": {
      "totalNum": 100       // 符合条件的病历结果总数，用于计算翻页总页数
    }
  }

病历详情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-detail-emr)

  {
    "method": "cdss-detail-emr",
    "id": ["相似病历推荐API和病历检索API结果中的id"]
  }

Response

请点击箭头查看内容

  {
    "code": 0,
    "message": "",
    "result": [
      {
        "id": "00003",
        "诊疗类型": "门诊/住院",
        "年龄": "67岁",
        "性别": "男",
        "科室": "呼吸内科",
        "emr": [
          {
            "type": "入院记录",
            "date": "2018-01-12",
            "fields": [     // 展现字段有序列表，根据病历类型动态调整
              "主诉",
              "现病史",
              "体格检查"
            ],
            "主诉": "",
            "现病史": "",
            "体格检查": ""
          }
        ]
      }
    ]
  }

伴随症状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 = symptom-generate)

  {
    "method": "symptom-generate",  
    "query": "",                     //[必填]入参
    "sex": "男/女",                  //性别
    "age": "18岁",                   //年龄  
    "dep": ""                        //科室
  }

Response

请点击箭头查看内容

  {
    "code": 0,  
    "message": "symptom_generate-success", 
    "result": [                            //结果
        "头晕",
        "咽痛",
        "腹痛",
        "呕吐",
        "恶心",
        "咳痰",
        "发热",
        "腹泻",
        "流涕",
        "咳嗽",
        ... ...
    ]
  }

错误码定义¶

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