身份证识别免费api接口

美雨知春

已于 2024-02-01 12:06:41 修改

阅读量2.2k

点赞数 28

分类专栏： OCR图像识别文章标签： ocr

于 2024-01-31 13:40:13 首次发布

本文链接：https://blog.csdn.net/weixin_41722180/article/details/135949813

版权

OCR图像识别专栏收录该内容

34 篇文章

订阅专栏

身份证识别

支持对二代居民身份证正反面所有8个字段进行结构化识别，包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限。

请求示例

HTTP 方法：POST

请求URL： http://39.106.33.248:8088/idcard

Header如下：

参数	值
Content-Type	text/plain;charset=UTF-8

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

请求参数

form-data参数

参数	是否必选	类型	可选值范围	说明
multipartFile	是	file	-	上传本地图片

Query参数

返回示例（身份证头像面）：

{
    "words_result": {
        "姓名": { 
            "location": {
                "top": 273,
                "left": 655,
                "width": 153,
                "height": 54
            },
            "words": "蔡**"
        },
        "民族": {
            "location": {
                "top": 367,
                "left": 874,
                "width": 45,
                "height": 46
            },
            "words": "汉"
        },
        "住址": {
            "location": {
                "top": 539,
                "left": 655,
                "width": 457,
                "height": 110
            },
            "words": "江苏省海门市***"
        },
        "公民身份号码": {
            "location": {
                "top": 759,
                "left": 831,
                "width": 598,
                "height": 61
            },
            "words": "320****874"
        },
        "出生": {
            "location": {
                "top": 450,
                "left": 650,
                "width": 365,
                "height": 49
            },
            "words": "20000428"
        },
        "性别": {
            "location": {
                "top": 368,
                "left": 654,
                "width": 37,
                "height": 47
            },
            "words": "男"
        }
    },
    "words_result_num": 6, 
    "idcard_number_type": 1, 
    "image_status": "normal",
    "risk_type": "normal",
    "log_id": 1752224492569240506
}

返回示例（身份证国徽面）：

{
    "words_result": {
        "失效日期": {
            "location": {
                "top": 809,
                "left": 1116,
                "width": 230,
                "height": 57
            },
            "words": "20260829"
        },
        "签发机关": {
            "location": {
                "top": 710,
                "left": 853,
                "width": 281,
                "height": 54
            },
            "words": "海门市公安局"
        },
        "签发日期": {
            "location": {
                "top": 812,
                "left": 850,
                "width": 240,
                "height": 59
            },
            "words": "20160829"
        }
    },
    "words_result_num": 3,
    "image_status": "reversed_side",
    "risk_type": "normal",
    "log_id": 1752541486675194419
}

返回参数

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
words_result	是	array[]	定位和识别结果数组
words_result_num	是	uint32	识别结果数，表示words_result的元素个数
direction	否	int32	图像方向，输入参数 detect_direction= true 时返回。 - - 1：未定义， - 0：正向， - 1：逆时针90度， - 2：逆时针180度， - 3：逆时针270度
image_status	是	string	normal-识别正常 reversed_side-身份证正反面颠倒 non_idcard-上传的图片中不包含身份证 blurred-身份证模糊 other_type_card-其他类型证照 over_exposure-身份证关键字段反光或过曝 over_dark-身份证欠曝（亮度过低） unknown-未知状态
risk_type	否	string	输入参数 detect_risk = true 时，则返回该字段识别身份证风险类型: normal-正常身份证； copy-复印件； temporary-临时身份证； screen-翻拍； unknown-其他未知情况
edit_tool	否	string	如果参数 detect_risk = true 时，则返回此字段。如果检测身份证被编辑过，该字段指定编辑软件名称，如:Adobe Photoshop CC 2014 (Macintosh),如果没有被编辑过则返回值无此参数
card_quality	否	object	输入参数 detect_quality = true 时，则返回该字段识别身份证质量类型
+ IsClear	是	string	质量类型，是否清晰
+ IsClear_propobility	是	string	“是否清晰”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsClear_propobility 超过0.5时，对应 IsClear 返回1，低于0.5，则返回0
+ IsComplete	是	string	质量类型，是否边框/四角完整
+ IsComplete_propobility	是	string	“是否边框/四角完整”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsClear_propobility 超过0.5时，对应 IsComplete 返回1，低于0.5，则返回0
+ IsNoCover	是	string	质量类型，是否头像、关键字段无遮挡/马赛克
+ IsNoCover_propobility	是	string	“是否头像、关键字段无遮挡/马赛克”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsNoCover_propobility 超过0.3时，对应IsNoCover 返回1，低于0.3，则返回0
photo	否	string	当请求参数 detect_photo = true时返回，头像切图的 base64 编码（无编码头，需自行处理）
photo_location	否	object	当请求参数 detect_photo = true时返回，头像的位置信息（坐标0点为左上角）
card_image	否	string	当请求参数 detect_card = true时返回，身份证裁剪切图的 base64 编码（无编码头，需自行处理）
card_location	否	object	当请求参数 detect_card = true时返回，身份证裁剪切图的位置信息（坐标0点为左上角）
idcard_number_type	是	int	用于校验身份证号码、性别、出生是否一致，输出结果及其对应关系如下： - 1：身份证正面所有字段全为空 0：身份证证号不合法，此情况下不返回身份证证号 1：身份证证号和性别、出生信息一致 2：身份证证号和性别、出生信息都不一致 3：身份证证号和出生信息不一致 4：身份证证号和性别信息不一致
+ location	是	array[]	位置数组（坐标0点为左上角）
++ left	是	uint32	表示定位位置的长方形左上顶点的水平坐标
++ top	是	uint32	表示定位位置的长方形左上顶点的垂直坐标
++ width	是	uint32	表示定位位置的长方形的宽度
++ height	是	uint32	表示定位位置的长方形的高度
+ words	否	string	识别结果字符串