灵医智惠CDSS高级版-病案质控API开发指南v2—终末质控获取质控结果API
| 产品功能 |
API |
URL |
method |
使用使用场景 |
涉及单据 |
|
终末质控获取质控结果 |
/cdss/platform/api/v2 |
|
|
|
终末质控获取质控结果 API功能
终末质控获取质控结果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
{
"method": "cdss-imr-result-v2",
"params": [
{ // 以下六项查询条件至少填一项
"patientId": ["", ""], // 患者ID(就诊卡号)列表
"visitId": ["", ""], // 就诊ID(住院号)列表
"mrNo": ["", ""], // 病案号列表
"admissionTime": { // 入院时间范围
"start": "yyyy-MM-dd",
"end": "yyyy-MM-dd"
},
"dischargeTime": { // 出院时间范围
"start": "yyyy-MM-dd",
"end": "yyyy-MM-dd"
},
"reminderTime": { // 最新质控时间范围
"start": "yyyy-MM-dd",
"end": "yyyy-MM-dd"
}
}
]
}
{
"code": 0, // 状态码, 0为成功, 非0为失败
"message": "", // 报错信息, code不为0时使用
"result": [
{
"hospitalName": "", // 医院名称
"patientId": "", // 患者ID(就诊卡号)
"visitId": "", // 就诊ID(住院号)
"mrNo": "", // 病案号
"patientName": "", // 患者姓名
"doctorId": "", // 医生工号
"reminderTime": "yyyy-MM-dd HH:mm:ss", // 最新质控时间
"statics": { // 同一病历下所有评分标准质控点提醒等级数量统计结果
"msg": "入院记录(2)、首次病程记录(3)、出院记录(4)、病程记录(1)",
"error": 0, // 提醒等级为 强制 质控点数量
"notice": 0, // 提醒等级为 建议 质控点数量
"warning": 0, // 提醒等级为 提醒 质控点数量
"specify_error": {
"admission_record": 2, // 入院记录类型强制质控点数量
"first_course": 3, // 首次病程记录类型强制质控点数量
"discharge_record": 4, // 出院记录类型强制质控点数量
"other": 1 // 病程记录类型强制质控点数量
}
},
"reminderResult": [ // 质控结果
{ // 每个质控标准一个dict
"standardName": "HQMS", // 质控标准名
"score": 100, // 病历评分
"level": 0, // 0->甲级, 1->乙级, 2->丙级
"statics": { // 同一病历下某一评分标准下所有质控点提醒等级数量统计结果
"msg": "入院记录(2)、首次病程记录(3)、出院记录(4)、病程记录(1)",
"error": 0, // 提醒等级为 强制 质控点数量
"notice": 0, // 提醒等级为 建议 质控点数量
"warning": 0, // 提醒等级为 提醒 质控点数量
"specify_error": {
"admission_record": 2, // 入院记录类型强制质控点数量
"first_course": 3, // 首次病程记录类型强制质控点数量
"discharge_record": 4, // 出院记录类型强制质控点数量
"other": 1 // 病程记录类型强制质控点数量
}
}
"defectList": [ // 质控缺陷详情
{
"ruleId": "", // 质控点ID, 人工添加的质控缺陷该项为空
"ruleName": "", // 质控点名称, 人工添加的质控缺陷该项为空
"defectId": "", // 质控缺陷唯一ID
"message": "", // 质控提示信息
"veto": 0, // 单项否决等级, 0->非单项否决, 1->单项乙, 2->单项丙
"score": 1, // 扣分分值
"emrId": "", // 触发质控点的单据记录ID(跨单据质控返回主要单据的ID)
"emrName": "", // 触发质控点的单据名称(跨单据质控返回主要单据的名称)(cdss v2 schema中定义的单据名称)
"defectType": "编码质控/内涵质控/形式质控", // 缺陷大类
"ruleType":"", //缺陷类型
"remindLevel": "error(强制)/notice(建议)/warning(提醒)", // 质控点提醒等级
"defect_status": {
"appeal": 0, // 是否申诉 0未申诉；1已申诉
"appeal_msg": "", // 申诉时的原因
"deleted": false, // 缺陷是否删除 false 未删除；true已删除
"reject": 0, // 申诉驳回状态， -1 申诉驳回；0未审核；1申诉成功
"reject_msg": "", // 申诉驳回原因
"status": 1 // 缺陷状态， 0-申诉通过；1-已整改；2-待整改；3-申诉驳回；4-临床申诉
},
}
]
},
{...}
]
},
{...}
]
}
错误码定义
| 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 |
不支持的资源 |