/ocr/degree_certificate
1.接口描述
该API是用于识别提取学位证书上的文字信息。
请求方式：
POST
请求URL：
https://cloudapi.deepfinch.com/ocr/degree_certificate
调试工具
2.请求参数
2.1 请求头域
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| X-DF-API-ID | string | 是 | API调用凭证信息，详细信息请参考API调用 |
| X-DF-API-SECRET | string | 是 | API调用凭证信息，详细信息请参考API调用 |
2.2 请求体
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| file | file | 见下方注释 | 需上传的图片文件，上传本地图片进行检测时选取此参数 |
| url | string | 见下方注释 | 图片网络地址，采用抓取网络图片方式时需选取此参数 |
请求参数
file与url二选一。
url 中若含有特殊字符，则需要对这些字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。
目前支持 http/https 协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。
参数file需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。
3.返回参数
| 字段 | 类型 | 描述 |
|---|---|---|
| request_id | string | 本次请求的 id |
| status | string | 状态。正常为 OK ，其他值表示失败。详见错误码 |
| result | object | 识别结果 |
3.1 result 字段的参数
| 字段 | 类型 | 说明 |
|---|---|---|
| name | object | 姓名 |
| school | object | 学校 |
| major | object | 专业 |
| degree_type | object | 学位类型 |
| end_date | object | 盖章日期 |
| book_id | object | 证书编号 |
| born_date | object | 出生日期 |
| sex | object | 性别 |
3.1.1 各字段的参数
| 字段 | 类型 | 说明 |
|---|---|---|
| value | string | 提取文本 |
| region | floatArray | 文本坐标 |
输出示例：
{
"status": "OK",
"request_id": "TID2131df36bf1a438c9ac4943178dd07ac",
"result": {
"book_id": {
"region": [
109.23,
865.37,
222.29,
865.37,
222.29,
896.01,
109.23,
896.01
],
"value": "1165842014003311"
},
"born_date": {
"region": [
218.45,
426.94,
1101.84,
421.2,
1103.76,
467.15,
220.37,
470.98
],
"value": "1991-06-23"
},
"degree_type": {
"region": [
448.4,
308.24,
1055.85,
308.24,
1055.85,
380.99,
448.4,
380.99
],
"value": "下学士学位"
},
"end_date": {
"region": [
1036.69,
867.29,
1387.37,
867.29,
1387.37,
901.75,
1036.69,
901.75
],
"value": "0一四年十月个个日"
},
"major": {
"region": [
346.84,
495.87,
488.64,
495.87,
488.64,
537.99,
346.84,
537.99
],
"value": "软件工程"
},
"name": {
"region": [
218.45,
426.94,
1101.84,
421.2,
1103.76,
467.15,
220.37,
470.98
],
"value": "王杰"
},
"school": {
"region": [
199.29,
735.19,
413.91,
735.19,
413.91,
779.22,
199.29,
779.22
],
"value": "南阳理工学院"
},
"sex": {
"region": [
218.45,
426.94,
1101.84,
421.2,
1103.76,
467.15,
220.37,
470.98
],
"value": "男"
}
}
}
4.错误码
| 状态码 | status 字段 |
说明 |
|---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
DETECTION_FAILED | 图片检测失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例：
{
"status": "INVALID_ARGUMENT",
"reason": "must specify 'file'",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}