智能多媒体服务

    • 智能多媒体服务 > API 文档 > 人脸核验 >功能接口 >身份证识别 OCR

    身份证识别 OCR

    最近更新时间: 2022-08-19 11:43:25

    接口简介

    七牛身份证识别OCR接口ocr-idcard ，检测单张身份证图片信息，例如：身份证中姓名、性别、民族、住址和身份证号码、有效期、签发地址等关键信息。

    注意

    • 接口超时时间为 30 秒
    • 资源的 Mime 文件格式仅支持图片类型：image/*，如：image/jpeg、image/png。
    • 请求接口为标准的HTTP/HTTPS 协议。
    • 证件照一般在178x220 ~ 480x640之间。人脸区域的像素，resize后尽量不要低于112x112。

    身份证拍摄注意事项

    • 原件拍摄；
    • 相机正对准身份证，让身份证尽量充满整张照片
    • 比较清晰，亮度适中，不反光

    请求语法

    POST /ocr/idcard HTTP/1.1
Host: ocr-idcard.qiniuapi.com
Content-Type: application/json
Authorization: QiniuToken

    头部信息

    头部名称 必填 说明
    Host 是 固定为 ocr-idcard.qiniuapi.com
    Content-Type 是 固定为 application/json
    Authorization 是 该参数应严格按照管理凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...

    访问权限

    请求body

    字段 是否必填 类型 说明
    session_id N string 唯一会话 id
    image Y string base64编码的图片数据
    ret_image N bool 是否返回识别后的切图(切图是指精 确剪裁对齐后的身份证正反面图片)，返回格式为 JPEG 格式二进制图片使用 base64 编码后的字符串
    ret_portrait N bool 是否返回身份证(人像面)的人脸图 片，返回格式为 JPEG 格式二进制图片使用 base64 编码后的字符串
    ref_side N string 当图片中同时存在身份证正反面时， 通过该参数指定识别的版面:取值’Any’ - 识别人像面或国徽面，‘F’ - 仅 识别人像面，‘B’ - 仅识别国徽面
    enable_border_check N bool 身份证遮挡检测开关，如果输入图片中的身份证卡片边框不完整则返回告警
    enable_detect_copy N bool 复印件、翻拍件检测开关，如果输入图片中的身份证卡片是复印件，则返回告警

    返回

    字段 类型 说明
    session_id string 唯一会话 id
    errorcode int 返回状态码
    errormsg string 返回错误消息
    warnmsg [ ]string 多重警告码
    ocr_result OcrResult 文字识别结果
    image_result ImageResult 图片检测结果

    OcrResult

    字段 类型 说明
    side string F-身份证人像面，B-身份 证国徽面
    idno string 身份号码(人像面)
    name string 姓名(人像面)
    nation string 民族(人像面)
    gender string 性别(人像面)
    address string 地址(人像面)
    birthdate string 生日(人像面) eg. “19900111”
    validthru string 有效期(国徽面) eg. “20001010-20101009”
    issuedby string 签发机关(国徽面)

    ImageResult

    字段 类型 说明
    idcard string 身份证区域图片，使用Base64 编码后的字符串， 是否返回由请求参数ret_image 决定
    portrait string 身份证人像照片，使用Base64 编码后的字符串， 是否返回由请求参数ret_portrait 决定
    idcard_bbox [ ]Point 框坐标，格式为 [[x0, y0], [x1, y1], [x2, y2], [x3, y3]]

    示例

    POST /ocr/idcard HTTP/1.1
Host: ocr-idcard.qiniuapi.com
Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
Content-Type: application/json 
{
	“image”: IMAGEA_DATA,
}

    返回示例

    人像面

    {"errorcode": 0, "errormsg": "OK", "warnmsg": [], "ocr_result": {"side": "F", "idno": "310225********1219", "name": "张麒麟", "nation": "汉", "gender": "男", "address": "云南省昆明市寻甸回发彝族自治县七星乡必寨村委会老长地村26号", "birthdate": "19911109"}, "image_result": {"idcard_bbox": [[8, 138], [8, 8], [210, 8], [210, 138]]}, "session_id": "1"}

    国徽面

    {"errorcode": 0, "errormsg": "OK", "warnmsg": [], "ocr_result": {"side": "B", "validthru": "20121008-20321008", "issuedby": "签发地"}, "image_result": {"idcard_bbox": [[15, 753], [15, 389], [572, 389], [572, 753]]}, "session_id": "1"}

    错误码

    错误码 错误信息 HTTP 状态码
    0 识别正常 200
    53090001 请求解析失败 400
    53090002 图片解码错误 400
    53090003 OCR 内部错误 500
    53090004 无法识别的身份证(非中国身份证等) 200
    53090005 参数错误 200
    55060030 鉴权失败 400

    告警码

    告警码 含义
    53091001 黑白复印件
    53091003 无法检测到人脸
    53091004 证件信息缺失或错误
    53091005 证件过期
    53091006 身份证不完整
    以上内容是否对您有帮助？
    • Close