接口简介

七牛身份证识别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

头部信息

访问权限

请求body

返回

OcrResult

ImageResult

示例

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": "310225199111091219", "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"}

错误码

告警码