/ocr/medical_admission_note_icd10
1.接口描述
该 API 用于识别提取入院记录上的文字信息并返回对应的医疗文本解析信息。
- 图片要求:
- 格式为 JPG(JPEG), PNG
- 宽和高大于 128px, 小于等于 6000px
- 小于等于 5 MB
请求方式
POST
https://cloudapi.deepfinch.com/ocr/medical_admission_note_icd10/basic
调试工具
Debugging Tool
2.请求参数
2.1 请求头域
字段 |
类型 |
必需 |
描述 |
X-DF-API-ID |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
X-DF-API-SECRET |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
2.2 请求体
字段 |
类型 |
必需 |
描述 |
file |
file |
见下方注释 |
需上传的图片文件,上传本地图片进行检测时选取此参数 |
url |
string |
见下方注释 |
图片网络地址,采用抓取网络图片方式时需选取此参数 |
auto_rotate |
boolean |
否 |
是否开启图片自动旋转, 默认:false |
请求参数 file
与 url
二选一。
url 中若含有特殊字符,则需要对这些字符进行转义,所有中文和特殊字符必需以UTF-8编码转义。
目前支持 http/https 协议的网络地址。下载限时 5s,超时后仍未下载完成则属于失败。
参数 file
需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。
3.返回参数
字段 |
类型 |
说明 |
request_id |
string |
本次请求的id |
image_id |
string |
请求图片对应的id |
status |
string |
状态,正常为 OK |
degree |
int |
图片旋转角度 |
medical_result |
object |
提取结果 |
3.1 medical_result 字段的参数:
字段 |
类型 |
说明 |
patient_name |
string |
患者姓名 |
hospital_name |
string |
医院名称 |
start_hospital_date |
string |
入院日期 |
chief_complaint |
array |
主诉 |
current_medical_history |
array |
现病史 |
past_history |
array |
既往史 |
personal_history |
array |
个人史 |
family_history |
array |
家族史 |
marriage_and_childbirth_history |
array |
婚育史 |
icd10_result |
array |
医疗文本解析结果 |
3.2 icd10_result 字段的参数:
字段 |
类型 |
说明 |
chief_complaint |
array |
主诉 |
current_medical_history |
array |
现病史 |
past_history |
array |
既往史 |
personal_history |
array |
个人史 |
family_history |
array |
家族史 |
marriage_and_childbirth_history |
array |
婚育史 |
3.3 icd10_result 各字段说明:
字段 |
说明 |
字段一 |
解析结果 |
字段二 |
ICD-10名称,类型为疾病时输出 |
字段三 |
ICD-10代码,类型为疾病时输出 |
字段四 |
解析结果所属类型(疾病,手术,阳性不良嗜好,阳性症状) |
字段五 |
发病时间 |
返回结果示例
{
"request_id": "TID7a379a30cbf74c96935cd15dd0381e76",
"status": "OK",
"image_id": "5c431d04916449829594bd313cf040eb",
"degree": 0,
"medical_result": {
"chief_complaint": [
"发热、咳嗽5天。"
],
"current_medical_history": [
"患儿于5天前出现发热体温最高38.5℃左右,无寒战及抽搐,无吐泻,同时伴有咳嗽,呈阵发性连声咳,非痉挛性,有痰,略喘憋,无声嘶,无胸闷胸痛。在外口服\"布洛芬、罗红霉素\"及雾化吸入,效果不佳,流涕、体温反复,咳嗽加重,故来诊。门诊以\"支气管肺炎\"收入院。患儿病后食欲睡眠可,大小便正常。"
],
"family_history": [
"父母体健,非近亲婚配,否认传染病及遗传病家族史。"
],
"hospital_name": "东营胜利胜采医院",
"icd10_result": {
"chief_complaint": [
[
"发热、咳嗽",
"",
"",
"阳性症状",
"2019-02-04"
]
],
"current_medical_history": [
[
"发热体温最高38.5℃左右",
"",
"",
"阳性症状",
"2019-02-04"
],
[
"同时伴有咳嗽",
"",
"",
"阳性症状",
"2019-02-04"
],
[
"呈阵发性连声咳",
"",
"",
"阳性症状",
"2019-02-04"
],
[
"非痉挛性,有痰",
"",
"",
"阳性症状",
"2019-02-04"
],
[
"略喘憋",
"",
"",
"阳性症状",
"2019-02-04"
],
[
"支气管肺炎",
"支气管肺炎",
"J18.000",
"疾病",
"2019-02-04"
]
],
"family_history": [],
"past_history": [],
"personal_history": []
},
"marriage_and_childbirth_history": [
"无。"
],
"past_history": [
"无病毒性肝炎、伤寒、肺结核等传染病病史及密切接触史,无外伤及手术史。无药物过敏史。已接种卡介苗、乙肝及脊髓灰质炎、百白破、麻疹等疫苗。"
],
"patient_name": "xxx",
"personal_history": [
"其母孕期体健,无毒物及放射线接触史。患儿为第二胎第二产,足月顺产,新法接生,生后无窒息,出生体重3.3Kg。纯母乳喂养至今。生长发育正常。"
],
"start_hospital_date": "2019-02-09"
}
}
4.错误码
状态码 |
status 字段 |
说明 |
400 |
INVALID_ARGUMENT |
请求参数错误 |
400 |
DETETION_FAILED |
图片检测失败 |
400 |
DOWNLOAD_ERROR |
网络地址图片获取失败 |
401 |
UNAUTHORIZED |
未授权或授权失败 |
401 |
KEY_EXPIRED |
账号过期 |
403 |
NO_PERMISSION |
无调用权限 |
403 |
OUT_OF_QUOTA |
调用次数超出限额 |
403 |
RATE_LIMIT_EXCEEDED |
调用频率超出限额 |
404 |
NOT_FOUND |
请求路径错误 |
500 |
INTERNAL_ERROR |
服务器内部错误 |
备注: 以上40X系列错误描述请参考reason
字段
输出样例
{
"status": "INVALID_ARGUMENT",
"reason": "must specify 'file' or 'url' argument",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}
5.输入示例