灵医书写助手API开发指南v2—同步（医学术语智能编码）API
| 产品功能 |
API |
method |
建议使用场景 |
| 同步（医学术语智能编码）API |
医学术语智能编码API |
cdss-mrhp-icd-coding |
医学术语智能编码 |
同步（医学术语智能编码）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-icd-coding |
| type |
string |
是 |
术语表达的类型 |
disease、operate |
| query |
string |
是 |
医学术语表达 |
哮喘 |
| version |
string |
否（缺省值：医保） |
ICD版本 |
医保、临床、标准 |
{
"method": "cdss-mrhp-icd-coding",
"type": "disease",
"query": "哮喘",
"version": "医保"
}
| 返回字段 |
说明 |
示例 |
| code |
服务结果状态 |
|
| message |
返回信息 |
|
| result |
返回icd编码信息；若不是标准医学表达，会返回Top3个相似结果；若指定version，则返回对应version结果，若不指定，默认返回医保版结果 |
"SUCCESS"、"cdss-mrhp-icd-coding: query can't be an empty string" |
{
"code": 0,
"result": [
{
"临床版icd编码": "J45.900",
"临床版亚目": {
"名称": "未特指的哮喘",
"编码": "J45.9"
},
"临床版术语": "哮喘",
"临床版类目": {
"名称": "哮喘",
"编码": "J45"
},
"医保版icd编码": "J45.900",
"医保版亚目": {
"名称": "未特指的哮喘",
"编码": "J45.9"
},
"医保版术语": "哮喘",
"医保版类目": {
"名称": "哮喘",
"编码": "J45"
},
"术语名称": "哮喘",
"标准版icd编码": "J45.900",
"标准版亚目": {
"名称": "未特指的哮喘",
"编码": "J45.9"
},
"标准版术语": "哮喘",
"标准版类目": {
"名称": "哮喘",
"编码": "J45"
}
}
]
}
错误码定义
| 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 |
不支持的资源 |