灵医书写助手API开发指南v2—同步（首页质控）API¶
| 产品功能 | API | method | 建议使用场景 |
|---|---|---|---|
| 首页质控（编码规范） | 首页编码质控API | cdss-reminder-mrhp-sync | 病案首页质控场景 |
首页质控（内涵规范）¶
首页编码质控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规范》)
json
{
"method": "cdss-reminder-mrhp-sync",
"params": [
{
"id_list": [
"00600", "00601", "00602",
"00306", "00307", "00308",
"00309", "00310", "00311"
] // 必选，指定只执行“编码规范”的质控能力
}
],
"emr": {
"病案首页": [
{
"记录ID": "xx",
"诊断": [
{
"诊断类型": "出院诊断",
"诊断项": "上消化道出血",
"疾病编码": "K92.2",
"主要诊断": "是"
},
{
"诊断类型": "出院诊断",
"诊断项": "胃溃疡",
"疾病编码": "K25.9"
}
]
}
]
}
}
- Response
json
{
"code": 0,
"message": "",
"result": [
{
"level":"notice",
"message":"当编码【K92.2】和编码【K25.9】同时存在，合并为编码【K25.4】",
"rule_id":"00310",
"fact_id": "1", // 条件编号，用于标识当前结果由哪一种条件触发的，调用方可以按照需求根据rule_id，fact_id进行更加细粒度的筛选
"rule_name":"当A和B同时存在，合并为C（不止A、B）",
"rule_type":"合并编码",
"source":[
{
"doc":"病案首页",
"doc_id":"xx",
"key":"出院诊断",
"mention":"",
"offset":-1
},
{
"doc":"病案首页",
"doc_id":"xx",
"key":"出院诊断",
"mention":"",
"offset":-1
}
],
"type":"文书"
}
]
}
错误码定义¶
| 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 | 不支持的资源 |