社保卡OCR

---

接口描述

通过光学字符识别技术，对社保卡图片进行识别.

请求说明

HTTP 方法:

POST

请求 URL：

/ai-cloud-face/api/ocr/sscard

Header如下：

参数名称	值
Content-Type	application/json;charset=UTF-8

Body中放置请求参数，参数详情如下：

请求参数：

参数名称	必填	数据类型	长度	参数描述
img	是	String	1-3000k	待处理图片(base64 编码)，原始图片大小需要小于 3M;
busFlowId	否	String	0-64	业务流水号，业务系统唯一序列号（对账用，建议传入）

请求示例：

{
    "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}

返回说明

返回参数：

返回值名称	数据类型	长度	描述
code	int	1-8	返回结果，0表示成功
message	String	1-255	返回码描述
data	Object	-	返回的数据
-busFlowId	String	1-64	业务流水号，业务系统唯一序列号
-flowId	String	1-64	交易流水ID（建议保存）
-SSCardOcrRet	Object	-	社保卡OCR识别结果
--SSCardName	OcrRet	-	姓名
--SSCardGender	OcrRet	-	性别
--SSCardNumber	OcrRet	-	卡号
--SS_Number	OcrRet	-	社会保障号码
--SSCardIssueDate	OcrRet	-	发卡日期
--SSCardValidDate	OcrRet	-	有效日期
--SSCardBankNumber	OcrRet	-	银行卡号
--SSCardAuthority	OcrRet	-	签发单位

OcrRet对象：

返回值名称	数据类型	长度	描述
key	String	1-64	属性key
data	String	1-511	属性值
pos	OcrPos	-	识别坐标

OcrPos对象：

返回值名称	数据类型	长度	描述
p1	Point	-	坐标1
p2	Point	-	坐标2
p3	Point	-	坐标3
p4	Point	-	坐标4

Point对象：

返回值名称	数据类型	长度	描述
x	int	1-4	x坐标
y	int	1-4	y坐标

返回示例：

{
    "code": 0,
    "data": {
        "SSCardOcrRet": {
            "SSCardNumber": {
                "data": "xxxxxx",
                "pos": {
                    "p1": {
                        "x": 638,
                        "y": 910
                    },
                    "p2": {
                        "x": 963,
                        "y": 912
                    },
                    "p3": {
                        "x": 963,
                        "y": 957
                    },
                    "p4": {
                        "x": 638,
                        "y": 955
                    }
                }
            },
            ......
            "SSCardBankNumber": {
                "data": "xxxxxxxxx",
                "pos": {
                    "p1": {
                        "x": 276,
                        "y": 1153
                    },
                    "p2": {
                        "x": 1342,
                        "y": 1169
                    },
                    "p3": {
                        "x": 1342,
                        "y": 1261
                    },
                    "p4": {
                        "x": 276,
                        "y": 1245
                    }
                }
            }
        }
    },
    "success": true,
    "message": "success"
}

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表

码值	是否成功	是否计费	描述
00000000	是	是	成功
50028100	否	否	图片不能为空
50028103	否	否	图片大小不能超过3M
50028282	否	否	社保卡识别异常
50028232	否	否	引擎检测异常
50028233	否	否	引擎检测异常
50028234	否	否	引擎检测异常