## 身份证识别接口 >[success]亮点:支持身份证图片地址识别!底层托管阿里云Serverless平台,性能稳定。支持对二代居民身份证正反面的关键字段识别,包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限,识别准确率可达98%以上 *调用地址:*http(s)://shenfenzhe.market.alicloudapi.com/do *请求方式:*POST *返回类型:*JSON | 名称 | 类型 | 是否必须 | 描述 | | --- | --- | --- | --- | | id\_card\_side | STRING | 必选 | front 正面 back反面 若正反面在一张图片上,需分别用正反参数解析两次 | | image | STRING | 必选 | 身份证图片外网地址或base64编码,不含data:image/jpeg;base64,前缀,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 | | detect\_direction | STRING | 可选 | 是否检测图像旋转角度,默认不检测,即:false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括: - true:检测旋转角度并矫正识别; - false:不检测旋转角度,针对摆放情况不可控制的情况建议本参数置为true。 | | detect\_risk | STRING | 可选 | 是否开启身份证风险类型(身份证复印件、临时身份证、身份证翻拍、修改过的身份证)功能,默认不开启,即:false。可选值:true-开启;false-不开启 | | detect\_photo | STRING | 可选 | 是否检测头像内容,默认不检测。可选值:true-检测头像并返回头像的 base64 编码及位置信息 | | detect\_rectify | STRING | 可选 | 是否进行完整性校验,默认为true,需上传各字段内容完善的图片方可识别;如果设置为false,则对于身份证切片(如仅身份证号区域)也可识别 | ## 返回说明 **返回参数** | 字段 | 一定返回 | 类型 | 说明 | | --- | --- | --- | --- | |msg|是|array|识别结果集| |--以下为正面返回 | | |--name||string|姓名| |--birthday||string|出生日期,格式为Ymd| |--sex||string|性别,男或女| |--idcardno||string|身份证号码| |--address||string|地址| |--nation||string|民族| |--以下为背面返回 | | |--gov||string|签发机关| |--begindate||string|签发日期,格式为Ymd| |--enddate||string|失效日期,格式为Ymd| | 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),如果没有被编辑过则返回值无此参数 | | log\_id | 是 | uint64 | 唯一的log id,用于问题定位 | | photo | 否 | string | 当请求参数 detect\_photo = true时返回,头像切图的 base64 编码(无编码头,需自行处理) | | photo\_location | 否 | array() | 当请求参数 detect\_photo = true时返回,头像的位置信息(坐标0点为左上角) | | idcard\_number\_type | 是 | string | 用于校验身份证号码、性别、出生是否一致,输出结果及其对应关系如下: **\-1:**身份证正面所有字段全为空 **0:**身份证证号识别错误 **1:**身份证证号和性别、出生信息一致 **2:**身份证证号和性别、出生信息都不一致 **3:**身份证证号和出生信息不一致 **4:**身份证证号和性别信息不一致 | | words\_result | 是 | array() | 定位和识别结果数组 | | words\_result\_num | 是 | uint32 | 识别结果数,表示words\_result的元素个数 | | +location | 是 | array() | 位置数组(坐标0点为左上角) | | ++left | 是 | uint32 | 表示定位位置的长方形左上顶点的水平坐标 | | ++top | 是 | uint32 | 表示定位位置的长方形左上顶点的垂直坐标 | | ++width | 是 | uint32 | 表示定位位置的长方形的宽度 | | ++height | 是 | uint32 | 表示定位位置的长方形的高度 | | +words | 否 | string | 识别结果字符串 | >[info] 在线调试:请点击调试按钮旁边的钥匙写入您的APPCODE ~~~[api] post:https://shenfenzhe.market.alicloudapi.com/do *string:image=http://storage.api51.cn/demo/zheng.jpg#身份证照片远程地址,正反面请分别请求 *id_card_side=front#front正面,back反面 <<< success <<< error ~~~