身份证识别接口
POST
http://shenfenzhe.market.alicloudapi.com/do
购买地址
身份证识别接口
亮点：支持身份证图片地址识别！底层托管阿里云Serverless平台，性能稳定。支持对二代居民身份证正反面的关键字段识别，包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限，识别准确率可达98%以上
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| 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 | 识别结果字符串 |
请求参数
Header 参数
Body 参数multipart/form-data
请求示例代码
返回响应
修改于 2025-06-17 03:14:55