/ocr/medical_classify_recognize
1.接口描述
该API可对不同对医疗票据进行分类、识别;分类支持住院发票、门诊发票、结算单、费用清单、出院小结;识别支持住院发票、门诊发票、费用清单、出院小结
- 图片要求:
- 格式为 JPG(JPEG),PNG
- 宽和高大于 128px,小于等于 6000px
- 小于等于 5 MB
请求方式
POST
请求 URL
https://cloudapi.deepfinch.com/ocr/medical_classify_recognize
调试工具
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 |
否 |
自动旋转图片,true开启,false不开启;默认不开启 |
请求参数 file 与 url 二选一。
url 中若含有特殊字符,则需要对这些字符进行转义,所有中文和特殊字符必需以UTF-8编码转义。
目前支持 http/https 协议的网络地址。下载限时 5s,超时后仍未下载完成则属于失败。
参数 file 需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。
3.返回参数
1.分类结果为结算单或其他类型时返回值:
| 字段 |
类型 |
说明 |
| request_id |
string |
本次请求的id |
| status |
string |
状态,正常为 OK |
| bill_type |
string |
分类结果 |
invoice: 发票
settlement: 结算单(分割单)
detail: 明细单
cyxj: 出院小结
unknown: 未知类型
返回结果示例
{
"request_id": "TIDc6500243286b4761be83493edc93729b",
"status": "OK",
"bill_type":“settlement”
}
2.分类结果为医疗发票、出院小结或者费用清单时返回值:
医疗发票返回值参考:
| 字段 |
类型 |
说明 |
| request_id |
string |
本次请求的id |
| status |
string |
状态,正常为 OK |
| degree |
int |
图片旋转角度 |
| province |
string |
所属省份 |
| bill_type |
string |
票据类型 'invoice' |
| medical_result |
object |
参考以下各接口 medical_result |
| 省份 |
输出值 |
| 其他 |
00 |
| 北京市(含中央) |
01 |
| 上海市 |
02 |
| 浙江省 |
03 |
| 天津市 |
04 |
| 山东省 |
05 |
| 河南省 |
06 |
| 广东省 |
07 |
| 江苏省 |
08 |
| 河北省 |
09 |
| 山西省 |
10 |
| 内蒙古 |
11 |
| 辽宁省 |
12 |
| 吉林省 |
13 |
| 黑龙江省 |
14 |
| 安徽省 |
15 |
| 福建省 |
16 |
| 江西省 |
17 |
| 湖北省 |
18 |
| 湖南省 |
19 |
| 广西 |
20 |
| 海南省 |
21 |
| 重庆市 |
22 |
| 四川省 |
23 |
| 贵州省 |
24 |
| 云南省 |
25 |
| 陕西省 |
26 |
| 甘肃省 |
27 |
| 宁夏 |
28 |
| 新疆 |
29 |
| 青海 |
30 |
| 西藏 |
31 |
| 解放军(含武警) |
32 |
出院小结返回值参考:
| 字段 |
类型 |
说明 |
| request_id |
string |
本次请求的id |
| status |
string |
状态,正常为 OK |
| degree |
int |
图片旋转角度 |
| bill_type |
string |
票据类型 'cyxj' |
| medical_result |
object |
同链接中medical_result /ocr/medical_discharge_report |
费用清单返回值参考:
| 字段 |
类型 |
说明 |
| request_id |
string |
本次请求的id |
| status |
string |
状态,正常为 OK |
| degree |
int |
图片旋转角度 |
| bill_type |
string |
票据类型 'detail' |
| medical_result |
object |
同链接中medical_result /ocr/medical_detail |
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.输入示例