Skip to content

护照 OCR


接口描述

通过光学字符识别技术,识别护照姓名、身份证号码、国家码、出生日期、出生地点、签发日期等结构化数据.

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-face/api/v1/ocrengine

Header如下:

参数名称
Content-Typeapplication/json;charset=UTF-8

Body中放置请求参数,参数详情如下:

请求参数:

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

请求示例:

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

返回说明

返回参数:

返回值名称数据类型长度描述
codeint1-8返回结果,0表示成功
messageString1-255返回码描述
dataObject-返回的数据
-busFlowIdString1-64业务流水号,业务系统唯一序列号
-flowIdString1-64交易流水ID(建议保存)
-ocrEngineRetObject-护照OCR识别结果
--TypeOcrRet-护照类型
--CountryCodeOcrRet-国家码
--SurnameOcrRet-
--GivennamesOcrRet-
--NameOcrRet-姓名
--NamePinyinOcrRet-姓名拼音
--SexOcrRet-性别
--NationalityOcrRet-国籍
--IdNumberOcrRet-身份证号
--DateofbirthOcrRet-出生日期
--PlaceofbirthOcrRet-出生地点
--DateofissueOcrRet-签发日期
--DateofexpiryOcrRet-有效期至
--PlaceofissueOcrRet-签发地点
--OfficeofissueOcrRet-签发机关
--PassportNoOcrRet-护照号码

OcrRet对象:

返回值名称数据类型长度描述
keyString1-64属性key
dataString1-511属性值
posOcrPos-识别坐标

OcrPos对象:

返回值名称数据类型长度描述
p1Point-坐标1
p2Point-坐标2
p3Point-坐标3
p4Point-坐标4

Point对象:

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

返回示例:

{
    "code": 0,
    "data": {
        "ocrEngineRet": {
            "Authority": {
                "data": "公安部出入境管理局",
                "pos": {
                    "p1": {
                        "x": 429,
                        "y": 681
                    },
                    "p2": {
                        "x": 723,
                        "y": 681
                    },
                    "p3": {
                        "x": 723,
                        "y": 717
                    },
                    "p4": {
                        "x": 429,
                        "y": 717
                    }
                }
            },
            ..........
            "Type": {
                "data": "P",
                "pos": {
                    "p1": {
                        "x": 401,
                        "y": 174
                    },
                    "p2": {
                        "x": 429,
                        "y": 174
                    },
                    "p3": {
                        "x": 429,
                        "y": 211
                    },
                    "p4": {
                        "x": 401,
                        "y": 211
                    }
                }
            }
        }
    },
    "success": true,
    "message": "success"
}

是否仍需要帮助? 请保持联络!