Skip to content

港澳台通行证识别


接口描述

通过光学字符识别技术,对港澳台通行证图片进行识别.

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-face/ocr/pass

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(建议保存)
-passRetObject-通行证OCR识别结果
--AddressString1-255住址
--BirthString1-16出生日期
--IDNumberString1-32证件号码
--IDTypeString1-4类型
--IssuanceDepartmentString1-32签发机关
--NameSpellingString1-32姓名拼音
--NumString1-4换证次数
--ValidPeriodString1-16有效期限
--NameString1-32姓名
--GenderString1-4性别
--validdate1String1-16有效期起始日期
--validdate2String1-16有效期截止日期
--IDCodeString1-32证件代码
--positionOcrRet[]-各字段的坐标信息

OcrRet对象:

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

OcrPos对象:

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

Point对象:

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

返回示例:

{
    "message": "success",
    "code": 0,
    "success": true,
    "data": {
        "passRet": {
            "Address": "广东",
            "Birth": "1981.08.03",
            "Gender": "女",
            "IDCode": "CSCA32732010<2901178<8108038<2",
            "IDNumber": "CA3273201",
            "IDType": "往来港澳通行证",
            "IssuanceDepartment": "中华人民共和国出入境管理局",
            "Name": "证件样本",
            "NameSpelling": "ZHENGJIAN,YANGBEN",
            "ValidPeriod": "2019.01.18-2029.01.17",
            "position": [{
                    "data": "Address",
                    "pos": {
                        "p1": {
                            "x": 748,
                            "y": 464
                        },
                        "p2": {
                            "x": 811,
                            "y": 464
                        },
                        "p3": {
                            "x": 811,
                            "y": 506
                        },
                        "p4": {
                            "x": 748,
                            "y": 506
                        }
                    }
                },
                {
                    "data": "Birth",
                    "pos": {
                        "p1": {
                            "x": 354,
                            "y": 292
                        },
                        "p2": {
                            "x": 550,
                            "y": 292
                        },
                        "p3": {
                            "x": 550,
                            "y": 330
                        },
                        "p4": {
                            "x": 354,
                            "y": 330
                        }
                    }
                },
                {
                    "data": "Gender",
                    "pos": {
                        "p1": {
                            "x": 625,
                            "y": 290
                        },
                        "p2": {
                            "x": 671,
                            "y": 289
                        },
                        "p3": {
                            "x": 672,
                            "y": 334
                        },
                        "p4": {
                            "x": 626,
                            "y": 335
                        }
                    }
                },
                {
                    "data": "IDCode",
                    "pos": {
                        "p1": {
                            "x": 56,
                            "y": 549
                        },
                        "p2": {
                            "x": 966,
                            "y": 547
                        },
                        "p3": {
                            "x": 966,
                            "y": 589
                        },
                        "p4": {
                            "x": 56,
                            "y": 591
                        }
                    }
                },
                {
                    "data": "IDNumber",
                    "pos": {
                        "p1": {
                            "x": 695,
                            "y": 49
                        },
                        "p2": {
                            "x": 969,
                            "y": 52
                        },
                        "p3": {
                            "x": 968,
                            "y": 101
                        },
                        "p4": {
                            "x": 694,
                            "y": 98
                        }
                    }
                },
                {
                    "data": "IDType",
                    "pos": {
                        "p1": {
                            "x": 173,
                            "y": 21
                        },
                        "p2": {
                            "x": 637,
                            "y": 21
                        },
                        "p3": {
                            "x": 637,
                            "y": 73
                        },
                        "p4": {
                            "x": 173,
                            "y": 73
                        }
                    }
                },
                {
                    "data": "IssuanceDepartment",
                    "pos": {
                        "p1": {
                            "x": 351,
                            "y": 464
                        },
                        "p2": {
                            "x": 721,
                            "y": 464
                        },
                        "p3": {
                            "x": 721,
                            "y": 506
                        },
                        "p4": {
                            "x": 351,
                            "y": 506
                        }
                    }
                },
                {
                    "data": "Name",
                    "pos": {
                        "p1": {
                            "x": 349,
                            "y": 134
                        },
                        "p2": {
                            "x": 561,
                            "y": 134
                        },
                        "p3": {
                            "x": 561,
                            "y": 184
                        },
                        "p4": {
                            "x": 349,
                            "y": 184
                        }
                    }
                },
                {
                    "data": "NameSpelling",
                    "pos": {
                        "p1": {
                            "x": 349,
                            "y": 190
                        },
                        "p2": {
                            "x": 764,
                            "y": 190
                        },
                        "p3": {
                            "x": 764,
                            "y": 234
                        },
                        "p4": {
                            "x": 349,
                            "y": 234
                        }
                    }
                },
                {
                    "data": "ValidPeriod",
                    "pos": {
                        "p1": {
                            "x": 349,
                            "y": 377
                        },
                        "p2": {
                            "x": 775,
                            "y": 378
                        },
                        "p3": {
                            "x": 775,
                            "y": 417
                        },
                        "p4": {
                            "x": 349,
                            "y": 416
                        }
                    }
                }
            ]
        }
    }
}

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