灵医书写助手API开发指南v2—同步（CHS-DRG预入组）API¶
| 产品功能 | API | method | 建议使用场景 |
|---|---|---|---|
| 同步（CHS-DRG预入组）API | CHS-DRG预入组API | cdss-mrhp-drg | CHS-DRG预入组 |
同步（CHS-DRG预入组）API功能¶
CHS-DRG预入组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
| 参数 | 类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| method | string | 是 | 首页引擎智能编码模块，固定值 | cdss-mrhp-drg |
| params | list | 是 | 预入组依赖参数 | |
| params.0.need_polling | bool | 否 | 是否需要轮询icd进行入组，默认为False（不轮询） | True;False |
| params.0.home_page_data | dict | 是 | 病案首页数据 | |
| params.0.home_page_data.患者基本信息 | dict | 是 | 患者基本信息 | 性别：1.男；2.女 |
| params.0.home_page_data.患者基本信息.性别 | string | 是 | "1.男";"2.女";"男";"女" | |
| params.0.home_page_data.患者基本信息.年龄(岁) | string | 是 | 年龄大于1岁的数据字段，单位为"岁"。和"年龄不足1周岁的年龄(天)"字段互斥，有且只有一个有效。可以设置为""，表示该字段无效 | "";"20" |
| params.0.home_page_data.患者基本信息.年龄不足1周岁的年龄(天) | string | 是 | 年龄小于1岁的数据字段，单位为"天"。和"年龄(岁)"字段互斥，有且只有一个有效。可以设置为""，表示该字段无效 | "";"60" |
| params.0.home_page_data.患者基本信息.新生儿出生体重 | string | 条件必须 | 患者是新生儿时，需要填写体重，单位为"克/g"。为""表示该字段无效。 | "3000"；"3000g"；"" |
| params.0.home_page_data.住院诊疗信息 | dict | 是 | 住院诊疗信息 | |
| params.0.home_page_data.住院诊疗信息.出院诊断(西医) | list | 是 | 诊断数据，必须要有诊断的icd编码（医保版），列表的第一项是主要诊断，后续是其他诊断 | ["K80.300x005","K80.000x004"] |
| params.0.home_page_data.住院诊疗信息.手术操作 | list | 否 | 手术操作数据，手术操作的icd编码（医保版），列表的第一项是主要手术或操作，后续是其他手术或操作 | ["45.0200x001","51.2200"] |
| params.0.home_page_data.住院诊疗信息.实际住院(天) | int | 否 | 住院天数 | 10 |
| params.0.home_page_data.住院诊疗信息.科别 | list | 否 | 病案的科别信息，需要符合后边的标准命名，可以是科别名称，也可以是科别代码 | 科别：病案所属科室，详见：首页科室规范 |
| params.0.home_page_data.住院诊疗信息.离院方式 | string | 否 | 枚举值，是"½/¾/5/9"其中一项。 1.医嘱离院 2.医嘱转院 3.医嘱转社区卫生服务机构/乡镇卫生院 4.非医嘱离院 5.死亡 9.其他 | "1" |
| params.0.自定义入组 | dict | 否 | 基于该字段的标准和协议，满足DRG的自定义入组需求 | 详见文档：自定义入组协议，新版已本地化，可不传该参数 |
| params.0.need_third_party | bool | 否 | 是否需要第三方分组器 | 默认false（不需要） |
| params.0.third_party | dict | 条件必须 | 如果需要第三方分组器，参数必传 | |
| params.0.third_party.url | string | 否 | 第三方分组器api地址 | http://{ip:port}/ocpu/library/CHSDRGs/R/CHSGrouper/json |
| params.0.third_party.drg_version | string | 否 | 第三方分组器版本 | 金豆 |
| params.0.third_party.inner_version | string | 否 | 第三方分组器的内部版本 | anyang |
| params.0.third_party.expand | dict | 否 | 预留字段，存储第三方分组器其他入参 | {} |
// 请求示例1
{
"params": [
{
"home_page_data": {
"患者基本信息": {
"年龄(岁)": 51,
"性别": "男",
"年龄不足1周岁的年龄(天)": "",
"新生儿出生体重": ""
},
"住院诊疗信息": {
"出院诊断(西医)": [
"K80.300x005",
"K80.000x004",
"K83.109",
"K79.800x006",
"E77.801",
"J94.804"
],
"手术操作": [
"45.0200x001",
"51.2200",
"51.1102",
"54.9101"
],
"实际住院(天)": 15,
"科别": [
"04"
],
"离院方式": "1"
}
}
}
],
"method": "cdss-mrhp-drg"
}
// 请求示例2
{
"params": [
{
"home_page_data": {
"患者基本信息": {
"年龄(岁)": 37,
"年龄不足1周岁的年龄(天)": "",
"性别": "2.女"
},
"住院诊疗信息": {
"离院方式": "1",
"出院诊断(西医)": [
"H33.002",
"K01.100",
"K09.204"
],
"手术操作": [
"12.8703",
"23.1902",
"76.2x04",
"24.3900x002"
],
"实际住院(天)": 4,
"科别": [
"10"
]
}
},
"need_polling": true
}
],
"method": "cdss-mrhp-drg"
}
- Response
| 返回字段 | 说明 | 示例 |
|---|---|---|
| code | 服务结果状态 | 0 |
| message | 返回信息（成功状态下无message） | "cdss-mrhp-drg: Not found home_page_data in params" |
| result | 返回预入组及建议结果，错误情况下返回[] | |
| result.0.mdc | 病案所属mdc | |
| result.0.adrg | 病案所属adrg | |
| result.0.drg | 病案所属drg | |
| result.0.drg_weight | drg的权重 | |
| result.0.drg_coefficient | drg的成本系数 | |
| result.0.drg_name | drg组中文名称 | |
| result.0.err_msg | drg预入组错误信息，包括内部错误、质控错误、入组错误等 | |
| result.0.status | 查询返回状态 | |
| result.0.icd_message | 病案涉及的icd相关信息 | |
| result.0.disease_icd | 入参的诊断的所属类型，包括：CC、MCC、不予识别（CC）、不予识别（MCC）等 | |
| result.0.operate_icd | 入参的手术操作的所属类型，包括：手术、诊断性操作、治疗性操作等 | |
| result.0.advice_type | 病案预入组失败的原因。目前有四类错误：主要诊断异常、主要诊断与主要手术及操作不一致、新生儿及其他围产期新生儿疾病诊断书写错误、主要诊断与新生儿出生体重不一致 | 主要诊断与主要手术及操作不一致 |
| result.0.advice | 病案预入组失败修改建议，其key为advice_type。其中："msg"是修正建议信息，仅供参考；"drg"是基于建议可能入到的drg组；"icd"是可能的修正icd | |
| result.0.polling_drg | 轮询诊断&手术操作的drg入组结果 | [{"drg":{"code":"DG25","name":"颅/面骨手术，不伴并发症或合并症","weight":0.859},"icd":{"major_diagnosis":{"code":"K01.100","name":"阻生牙"},"major_op":{"code":"76.2x04","name":"颌骨囊肿摘除术"}},"msg":"若以阻生牙（K01.100）为主要诊断、颌骨囊肿摘除术（76.2x04）为主要手术，可以预入组到：DG25（颅/面骨手术，不伴并发症或合并症），权重为0.859"},{"drg":{"code":"DJ19","name":"头颈、耳、鼻、咽、口其他手术","weight":0.607},"icd":{"major_diagnosis":{"code":"K01.100","name":"阻生牙"},"major_op":{"code":"23.1902","name":"阻生牙拔除术"}},"msg":"若以阻生牙（K01.100）为主要诊断、阻生牙拔除术（23.1902）为主要手术，可以预入组到：DJ19（头颈、耳、鼻、咽、口其他手术），权重为0.607"}] |
| result.0.reminder | 入参输入质控提醒，以字段维度展示 | {"性别": [{"docs": ["病案首页"], "id": "00168", "keys": [["性别"]], "level": "notice", "message": "病案首页-【性别】不在值域范围", "rule_id": "00168", "rule_name": "病案首页-【性别】不在值域范围", "rule_type": "首页逻辑错误", "score": -1, "source": [{"doc": "病案首页", "doc_id": "", "key": "性别", "mention": "", "offset": -1, "value": "不"}], "type": "文书"}]} |
// 结果示例1
{
"code": 0,
"result": [
{
"adrg": "",
"adrg_name": "",
"advice": {
"主要诊断与主要手术及操作不一致": {
"建议1": {
"drg": [
{
"code": "HU13",
"name": "急性胆道疾患，伴并发症或合并症",
"weight": 0.8553
}
],
"msg": "在忽略此手术操作代码的情况下，可能入到内科类的drg组：HU13（急性胆道疾患，伴并发症或合并症）"
},
"建议2": {
"drg": [
{
"code": "HC39",
"name": "胆囊切除手术",
"weight": 1.4523
}
],
"msg": "若以胆囊切除术（51.2200）为主要手术，可以预入组到：HC39（胆囊切除手术）"
},
"建议3": {
"drg": [
{
"code": "HC49",
"name": "除胆囊切除术以外的胆道手术",
"weight": 2.1664
},
{
"code": "HC19",
"name": "胆囊切除术伴胆总管手术",
"weight": 3.0526
},
{
"code": "HC19",
"name": "胆囊切除术伴胆总管手术",
"weight": 3.0526
}
],
"icd": [
{
"icd名称": "胆囊切开取石术",
"icd编码": "51.0401"
},
{
"icd名称": "胆管切开取石术",
"icd编码": "51.4900x002"
},
{
"icd名称": "肝管切开取石术",
"icd编码": "51.4901"
}
],
"msg": "找到相似度最高3个手术操作，是否可用于替换：胆囊切开取石术（51.0401）、胆管切开取石术（51.4900x002）、肝管切开取石术（51.4901）。若主要手术为51.0401可入到HC49（除胆囊切除术以外的胆道手术）；若主要手术为51.4900x002可入到HC19（胆囊切除术伴胆总管手术）；若主要手术为51.4901可入到HC19（胆囊切除术伴胆总管手术）"
}
}
},
"advice_type": "主要诊断与主要手术及操作不一致",
"disease_icd": {
"E77.801": "",
"J94.804": "CC",
"K79.800x006": "",
"K80.000x004": "不予识别（CC）",
"K80.300x005": "",
"K83.109": "不予识别（MCC）"
},
"drg": "",
"drg_coefficient": 0.0,
"drg_name": "",
"drg_weight": 0.0,
"err_msg": "非pre-mdc失败②-主要诊断与主要手术及操作不一致：K80.300x005、45.0200x001",
"icd_message": {
"K79.800x006": [
"icds_disease_db不存在该icd"
],
"K80.000x004": [
"与主要诊断关系密切，故不纳入CC和MCC识别"
],
"K83.109": [
"与主要诊断关系密切，故不纳入CC和MCC识别"
]
},
"mdc": "MDCH",
"operate_icd": {
"45.0200x001": "手术",
"51.1102": "诊断性操作",
"51.2200": "手术",
"54.9101": "治疗性操作"
},
"polling_drg": [],
"reminder": {},
"status": 0
}
]
}
// 结果示例2
{
"code": 0,
"result": [
{
"adrg": "CC1",
"adrg_name": "角膜、巩膜、结膜手术",
"advice": {},
"advice_type": "",
"disease_icd": {
"H33.002": "",
"K01.100": "",
"K09.204": ""
},
"drg": "CC19",
"drg_coefficient": 1.0,
"drg_name": "角膜、巩膜、结膜手术",
"drg_weight": 0.5612,
"err_msg": "success",
"icd_message": {},
"mdc": "MDCC",
"operate_icd": {
"12.8703": "手术",
"23.1902": "手术",
"24.3900x002": "手术",
"76.2x04": "手术"
},
"polling_drg": [
{
"drg": {
"code": "DG25",
"name": "颅/面骨手术，不伴并发症或合并症",
"weight": 0.859
},
"icd": {
"major_diagnosis": {
"code": "K01.100",
"name": "阻生牙"
},
"major_op": {
"code": "76.2x04",
"name": "颌骨囊肿摘除术"
}
},
"msg": "若以阻生牙（K01.100）为主要诊断、颌骨囊肿摘除术（76.2x04）为主要手术，可以预入组到：DG25（颅/面骨手术，不伴并发症或合并症），权重为0.859"
},
{
"drg": {
"code": "DJ19",
"name": "头颈、耳、鼻、咽、口其他手术",
"weight": 0.607
},
"icd": {
"major_diagnosis": {
"code": "K01.100",
"name": "阻生牙"
},
"major_op": {
"code": "23.1902",
"name": "阻生牙拔除术"
}
},
"msg": "若以阻生牙（K01.100）为主要诊断、阻生牙拔除术（23.1902）为主要手术，可以预入组到：DJ19（头颈、耳、鼻、咽、口其他手术），权重为0.607"
}
],
"reminder": {},
"status": 1
}
]
}
错误码定义¶
| 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 | 不支持的资源 |