# 印章识别
版本 V1.2.0
# 1. 接口定义
# 1.1 接口
URL = http://ip:port/hex/ocrapi/seal_ocr
其中 ip 为部署机器的 ip 地址,port 为对应服务器的端口
# 1.2 描述
智能印章识别支持各类印章,公章的文字识别;支持主字段与通用字段区分识别。主字段(公章公司名称,主要内容)、通用字段(除主字段外其余公章上的文字)。
# 1.3 HTTP请求格式
# 1.3.1 请求参数
| 参数名称 | 是否必选 | 类型 | 可选值 | 默认值 | 描述 | 
|---|---|---|---|---|---|
| app_id | 是 | String | 无 | 无 | 接入优图服务时生成的唯一id,用于唯一标识接入业务 | 
| image | 和url二选一 | String | 无 | 无 | 图像base64编码后的字符串,图像需是JPG、PNG、BMP其中之一的格式 | 
| url | 和image二选一 | String | 无 | 无 | 图片url地址,url与image两者填一个即可,同时赋值时,则以url指定的图像作为输入 | 
| session_id | 否 | String | 无 | 无 | 用户自定义的唯一会话id | 
# 1.3.2 请求示例
Request:
{
 "app_id": 填写对应的app_id,
 "image": 填写Base64编码后的图片数据,
 "session_id": 填写对应的session_id,
}
1
2
3
4
5
6
2
3
4
5
6
# 1.3.3 返回参数
| 字段 | 是否必然返回 | 类型 | 说明 | |
|---|---|---|---|---|
| errorcode | 是 | Int32 | 错误码 | |
| errormsg | 是 | String | 错误码消息 | |
| session_id | 否 | String | 相应请求的session标识符,可用于结果查询 | |
| items | ||||
| item | 是 | String | 识别出的字段名称(关键字),支持以下字段: Type:护照类型、Sex in English:性别(英文)、Country:签发国家、Passport No:护照编号、Date of birth:出生日期、Date of issue:发行日期、Date of expiry:到期日期、Place of issue in English:签发地点(英文)、Place of birth in English:出生地(英文)、Nationality in English:国籍(英文)、Code1:护照机读码1、Code2:护照机读码2、First Name in English:名(英文)、Family Name in English: 姓(英文)、Name:姓名 | |
| itemstring | 是 | String | 识别出的字段名称对应的值,也就是字段item对应的字符串结果 | |
| othercontent | 是 | Object | othertexts:通用文本字段列表 | |
| itemcoord | 是 | Object | 文本行在旋转纠正之后的图像中的像素坐标,表示为(左上角x, 左上角y,宽width,高height) | |
# 1.3.4 返回示例
Response:
{
    "errorcode": 0,
    "errormsg": "OK",
    "items": [
        {
            "itemstring": "xxxxx",
            "othercontent": {
                "Othertexts": [
                    "xxxx",
                    "xxxxx",
                    "xxxxx"
                ]
            },
            "itemcoord": {
                "y": 575,
                "x": 743,
                "height": 17,
                "width": 103
            }
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 1.3.5 接口错误码说明
| 错误码 | 错误码消息 | 错误码说明 | 
|---|---|---|
| -5208 | OCR_SERVER_INTERN_ERROR | 服务器内部错误 | 
| -1102 | SDK_IMAGE_DECODE_FAILED | 图片解码失败 | 
| -1400 | ERROR_OCR_TEMPLATE_NOT_MATCH | 模板不匹配 | 
| -9003 | GLOCR_RECOG_FAILED | OCR识别失败 | 
