Skip to content

灵医书写助手API开发指南v2—同步（首页回填）API

产品功能 API method 建议使用场景
首页回填 首页回填API cdss-mrhp-write-back 病案首页回填
首页退回 首页退回API cdss-hp-reject 病案首页退回

同步（首页回填）API功能

首页回填API

Warning

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

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

  • Request Body (emr格式参考文档《病案数据Schema规范》, 注意："工作人员信息"和"患者信息"为必填信息。) 

    {
    "method": "cdss-mrhp-write-back",
    "emr": {}
}

  • Response Body (result 数据参考文档《首页回填Schema规范》)

{
    "code": 0,
    "message": "",
    "result": [{}]
}

首页退回API

Warning

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

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

  • Request Body (emr格式参考文档《病案数据Schema规范》, 注意："工作人员信息"和"患者信息"为必填信息。) 

    {
    "method": "cdss-hp-reject",
    "emr": {
        "场景": ["病案首页"],
        "trigger": "提交",   
        "工作人员信息": {
            "医院": "",               // [必填]医院名称
            "科室": "",               // [必填]科室名称
            "姓名": "",               // [必填]工作人员姓名
            "账号ID": ""             // [必填]医疗信息系统账号    
        },
        "患者信息": {
            "就诊类型": "住院",      // [必填]
            "就诊ID": "",            // [必填] 住院号 或者 门诊号
            "患者ID": "",            // [必填]
            "病案号": ""             // [必填]
        },       
        "病案首页": {}               //非必填，如退回病案首页已在病案系统修改，退回时需将修改后内容一并退回，首页内容参考《病案数据Schema规范》文档       
    },
    "params": [
        {
            "message": ""            // 退回理由
        }
    ]
}

  • Response Body (result 数据参考文档《首页回填Schema规范》)

{
    "code": 0,                       //退回成功
    "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 不支持的资源