灵医书写助手API开发指南v2—同步（知识查询）API
| 产品功能 |
API |
method |
建议使用场景 |
| 医学知识查询(当前支持icd编码查询和DRG标签查询) |
知识查询 API |
cdss-mrhp-knowledge-seach |
医学知识查询 |
同步（知识查询）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
| 参数 |
类型 |
是否必须 |
说明 |
示例 |
| method |
string |
是 |
首页引擎智能编码模块，固定值 |
cdss-mrhp-knowledge-search |
| query |
string |
是 |
精确的查询信息(一个准确的标签名、adrg或者icd编码) |
"百日咳及急性支气管炎" |
| search_type |
string |
是 |
查询类型，标签查询 |
"label" |
| target_type |
string |
是 |
查询版本, 查询类型为标签查询时可选"disease"或"operate" |
"disease" |
| search_str_type |
string |
是 |
检索类型，标签名检索("label")、adrg检索("adrg")、icd编码检索("icd") |
"adrg" |
{
"method": "cdss-mrhp-knowledge-search",
"search_type": "label",
"target_type": "operate",
"query": "其他经皮心血管治疗",
"search_str_type": "label"
}
| 返回字段 |
说明 |
示例 |
| code |
服务结果状态 |
0、10200 |
| message |
返回信息 |
"SUCCESS"、"cdss-mrhp-knowledge-search: query can't be an empty string" |
| result |
返回结果 |
|
{
"code":"OK",
"message":"SUCCESS",
"result":[
{
"MDCF":{
"name":"循环系统疾病及功能障碍",
"FM2":{
"name":"其他经皮心血管治疗",
"SSJCZ0028":{
"name":"其他经皮心血管治疗",
"icd_list":{
"00.0200x001":"心脏血管治疗性超声",
"00.6600x004":"经皮冠状动脉球囊扩张成形术",
"00.6601":"经皮冠状动脉药物球囊血管内成形术",
"17.5500x002":"经皮冠状动脉粥样斑块切除术",
"17.5500x003":"经皮冠状动脉血栓抽吸术",
"17.5501":"经皮冠状动脉旋磨术",
"35.5502":"心脏室壁瘤封堵术，闭合法",
"36.0400":"冠状动脉内血栓溶解药输注",
"36.3400":"经皮经心肌血管再形成术",
"36.9900x011":"经皮冠状动脉瘘栓塞术",
"36.9900x012":"经皮冠状动脉瘘封堵术",
"37.2800":"心内超声心动图",
"37.9000x001":"经皮左心耳封堵术",
"37.9200x001":"心脏注射治疗",
"37.9900x003":"经皮右心耳封堵术",
"39.4901":"上腔静脉滤器取出术",
"39.5000x011":"下腔静脉球囊扩张成形术",
"39.5000x014":"主动脉球囊扩张成形术",
"39.5000x021":"上腔静脉球囊扩张成形术",
"39.5006":"肝静脉球囊血管成形术",
"39.5010":"腹主动脉球囊血管成形术",
"39.5400x001":"胸主动脉夹层动脉瘤开窗术",
"39.7100x004":"腹主动脉栓塞术",
"39.7101":"腹主动脉支架置入术",
"39.7102":"腹主动脉覆膜支架腔内隔绝术",
"39.7103":"腹主动脉分支覆膜支架置入术",
"39.7300x003":"主动脉覆膜支架腔内隔绝术",
"39.7300x004":"胸主动脉覆膜支架置入术(腋-腋、腋-颈、腋-腋-颈)[HYBRID复合手术]",
"39.7301":"胸主动脉支架置入术",
"39.7302":"胸主动脉分支覆膜支架置入术",
"39.7303":"胸主动脉覆膜支架腔内隔绝术",
"39.7800x001":"胸主动脉开窗分支覆膜支架置入术",
"39.7800x002":"腹主动脉开窗分支覆膜支架置入术",
"39.7900x003":"主动脉瘤支架置入术",
"39.9000x026":"动脉导管支架置入术"
}
}
}
}
}
]
}
| 参数 |
类型 |
是否必须 |
说明 |
示例 |
| method |
string |
是 |
首页引擎智能编码模块，固定值 |
cdss-mrhp-knowledge-search |
| query |
string |
是 |
查询信息(可以是空格分割的关键词，或者是拼音首字母字符串，或者是icd编码) |
"心脏治疗 超声" (关键字，空格分隔)，"xzzl"(拼音首字母)，"A01"(icd编码) |
| search_type |
string |
是 |
查询类型， icd 查询 |
"icd" |
| target_type |
string |
是 |
查询版本, 查询类型是icd 查询时，查询版本可选"医保"或"临床" |
"临床" |
| search_str_type |
string |
是 |
检索类型， icd名称关键词检索("icd_name"), icd名称拼音首字母检索("pinyin"),icd编码检索("icd") |
"icd" |
{
"method": "cdss-mrhp-knowledge-search",
"search_type": "icd",
"target_type": "医保",
"query": "心脏治疗 超声",
"search_str_type": "icd_name"
}
| 返回字段 |
说明 |
示例 |
| code |
服务结果状态 |
0、10200 |
| message |
返回信息 |
"SUCCESS"、 "cdss-mrhp-knowledge-search: query length should less than 100 and more than 1" |
| result |
查询结果, 返回top3, 并给出每个匹配结果的各版本信息 |
|
{
"code":"OK",
"message":"SUCCESS",
"result":[
{
"icd_10":[
],
"icd_9":[
{
"医保":{
"icd":"00.0200",
"name":"心脏治疗性超声",
"cate":{
"类目":"00",
"类目名称":"操作和介入，NEC",
"亚目":"00.0",
"亚目名称":"治疗性超声"
}
},
"标准":{
"icd":"00.0200",
"name":"心脏治疗性超声",
"cate":{
"类目":"00",
"类目名称":"操作和介入，不能分类于他处",
"亚目":"00.0",
"亚目名称":"治疗性超声"
}
},
"临床":{
"icd":"00.0200",
"name":"心脏治疗性超声",
"cate":{
"类目":"00",
"类目名称":"操作和介入，不能分类于他处",
"亚目":"00.0",
"亚目名称":"治疗性超声"
}
}
}
]
}
]
}
错误码定义
| 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 |
不支持的资源 |