合理用药
接口描述
本接口用于对中医处方的用药风险进行预警提示,减少用药事故的发生
接口调用示例
测试环境请求地址：https://qaapi.macrocura.com/open/api/tcm/rational-use/
正式环境请求地址：https://api.macrocura.com/open/api/tcm/rational-use/
请求方法：post
请求参数
R -- 必填 O -- 选填
| 字段名 | 类型 | 是否必填 | 详细描述 |
|---|---|---|---|
| app_id | string | 是 | 应用id，对接外部应用的唯一id号 |
| app_secret | string | 是 | 应用密钥，对接外部应用的秘钥，秘钥和id是一对一的关系 |
| auth_code | string | 是 | 授权码，一个设备使用一个 |
| hospital | object | 是 | 医院，50字限制 |
| doctor | object | 是 | 医生，50字限制 |
| medical_record_code | string | R | 病历编码 |
| patient_age | int | R | 患者年龄 |
| patient_gender | string | R | 患者性别 |
| is_menstruation | bool | O | 是否经期 |
| is_pregnancy | bool | O | 是否孕期 |
| diagnosis_type | int | R | 就诊类型,固定值填1 |
| prescriptions | Array | R | 支持多处方 |
医院
| 字段名 | 类型 | 详细描述 | 是否必填 |
|---|---|---|---|
| code | string | 医院编码 | 是 |
| name | string | 医院名称 | 否 |
医生
| 字段名 | 类型 | 详细描述 | 是否必填 |
|---|---|---|---|
| code | string | 医生编码 | 是 |
| name | string | 医生名称 | 否 |
处方
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| presc_no | int | R | 序号（第几个方剂） |
| is_double_sign | bool | R | 双签字机制（枚举：1，开启；2，关闭） |
| presc_count | int | R | 剂数 |
| tcm_items | Array | R | 中药组成 |
中药组成
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| tcm_code | String | R | 药品编码 |
| tcm_weight | float | R | 药品用量 |
响应参数
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | R | 返回业务状态码 |
| log_id | string | R | 日志id，便于追溯和排查问题 |
| success | bool | R | 请求是否成功 |
| msg | string | R | 失败或者成功信息 |
| data | object | R | 返回的数据 |
| medical_record_code | String | R | 病历编码 |
| prescriptions | Array | R | 处方 |
| old_code | int | R | 处方序号 |
| forbid_tcm | Object | R | 禁用药品 |
| double_sign_tcm | Object | R | 双签字药品（当处方关闭双签字后，原设置需要’双签字‘处理的将仅作’提示‘处理） |
| tips_tcm | Object | R | 提示药品 |
| is_exceed_dosage | bool | R | 处方剂数是否超标(任一处方剂数>7，则超标) |
禁用药品
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| excess_risk_tcms | Array | R | 超量禁用药品 |
| toxic_risk_tcms | Array [String] | R | 有毒禁用药品 |
| long_use_risk_tcms | Array [String] | R | 长期用药风险禁用药品 |
| menstruation_use_risk_tcms | Array [String] | R | 经期用药风险禁用药品 |
| pregnancy_use_risk_tcms | Array [String] | R | 孕期用药风险禁用药品 |
| internal_use_risk_tcms | Array [String] | R | 互联网医疗禁用药品 |
| compatibility_use_risk_tcms | Array [String] | R | 配伍禁用药品 |
超量禁用药品
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| tcm_code | String | R | 超量禁用药品(脉景中药品种名称) |
| tcm_weight | float | R | 超量禁用药品用量（饮片用量(精确度不超过两位小数) ） |
双签字药品
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| excess_risk_tcms | Array | R | 超量双签字药品 |
| toxic_risk_tcms | Array [String] | R | 有毒双签字药品 |
| long_use_risk_tcms | Array [String] | R | 长期用药风险双签字药品 |
| menstruation_use_risk_tcms | Array [String] | R | 经期用药风险双签字药品 |
| pregnancy_use_risk_tcms | Array [String] | R | 孕期用药风险双签字药品 |
| internal_use_risk_tcms | Array [String] | R | 互联网医疗双签字药品 |
| compatibility_use_risk_tcms | Array [String] | R | 配伍双签字药品 |
超量双签字药品
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| tcm_code | String | R | 超量双签字药品 |
| tcm_weight | float | R | 超量双签字药品用量(精确度不超过两位小数) |
提示药品
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| excess_risk_tcms | Array | R | 超量提示药品 |
| toxic_risk_tcms | Array [String] | R | 有毒提示药品 |
| long_use_risk_tcms | Array [String] | R | 长期用药风险提示药品 |
| menstruation_use_risk_tcms | Array [String] | R | 经期用药风险提示药品 |
| pregnancy_use_risk_tcms | Array [String] | R | 孕期用药风险提示药品 |
| internal_use_risk_tcms | Array [String] | R | 互联网医疗提示药品 |
| compatibility_use_risk_tcms | Array [String] | R | 配伍提示药品 |
超量提示药品
R -- 必填 O -- 选填
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| tcm_code | String | R | 超量提示药品 |
| tcm_weight | number | R | 超量提示药品用量 |
请求参数示例
{
"out_request_no": "1243",
"patient_age": 10,
"patient_gender": "F",
"is_menstruation": true,
"is_pregnancy": true,
"diagnosis_type": 1,
"prescriptions": [
{
"tcm_items": [
{
"tcm_code": "12311",
"tcm_weight": 1.2
},
{
"tcm_code": "12312",
"tcm_weight": 1.8
}
],
"presc_count": 7.2,
"is_double_sign": false,
"presc_no": 1
},
{
"tcm_items": [
{
"tcm_code": "12311",
"tcm_weight": 1.2
},
{
"tcm_code": "12312",
"tcm_weight": 1.8
}
],
"presc_count": 4.1,
"is_double_sign": true,
"presc_no": 2
}
]
}
返回错误码的含义：
| 错误码 | 错误信息 |
|---|---|
| 10000 | 服务器内部错误，请再次请求 |
| 10001 | 必填字段未填写： *字段 |
| 10002 | 字段类型错误： *字段 |
| 10003 | 字段长度错误： *字段 |
| 10004 | 字段范围错误： *字段 |
| 10005 | 字段枚举错误： *字段 |
| 10006 | 身份证认证不通过 |
响应成功示例
{
"code": 20000,
"success": true,
"msg": "成功",
"data": {
"out_request_no": "1243",
"prescriptions": [
{
"presc_no": 1,
"forbid_tcm": {
"excess_risk_tcms": [],
"toxic_risk_tcms": [],
"long_use_risk_tcms": [],
"menstruation_use_risk_tcms": [],
"pregnancy_use_risk_tcms": [],
"internal_use_risk_tcms": [],
"compatibility_use_risk_tcms": []
},
"double_sign_tcm": {
"excess_risk_tcms": [],
"toxic_risk_tcms": [],
"long_use_risk_tcms": [],
"menstruation_use_risk_tcms": [],
"pregnancy_use_risk_tcms": [],
"internal_use_risk_tcms": [],
"compatibility_use_risk_tcms": []
},
"tips_tcm": {
"excess_risk_tcms": [
{
"tcm_code": "12312",
"tcm_weight": 1.8
}
],
"toxic_risk_tcms": [
"12311"
],
"long_use_risk_tcms": [
"12311"
],
"menstruation_use_risk_tcms": [
"12311"
],
"pregnancy_use_risk_tcms": [
"12312"
],
"internal_use_risk_tcms": [],
"compatibility_use_risk_tcms": []
},
"is_exceed_dosage": true
},
{
"presc_no": 2,
"forbid_tcm": {
"excess_risk_tcms": [],
"toxic_risk_tcms": [],
"long_use_risk_tcms": [],
"menstruation_use_risk_tcms": [],
"pregnancy_use_risk_tcms": [],
"internal_use_risk_tcms": [],
"compatibility_use_risk_tcms": []
},
"double_sign_tcm": {
"excess_risk_tcms": [],
"toxic_risk_tcms": [
"12311"
],
"long_use_risk_tcms": [],
"menstruation_use_risk_tcms": [
"12311"
],
"pregnancy_use_risk_tcms": [],
"internal_use_risk_tcms": [],
"compatibility_use_risk_tcms": []
},
"tips_tcm": {
"excess_risk_tcms": [
{
"tcm_code": "12312",
"tcm_weight": 1.8
}
],
"toxic_risk_tcms": [],
"long_use_risk_tcms": [
"12311"
],
"menstruation_use_risk_tcms": [],
"pregnancy_use_risk_tcms": [
"12312"
],
"internal_use_risk_tcms": [],
"compatibility_use_risk_tcms": []
},
"is_exceed_dosage": true
}
]
}
}
响应失败示例
{
"code": 50000,
"success": false,
"msg": "请求参数出错: {'patient_gender': ['该字段是必填项。']}",
"data": null
}