## 身份证识别接口 >[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 ~~~