接口目录
接口文档
支持对二代居民身份证正反面所有8个字段进行结构化识别,包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限,识别准确率超过99%
选择开通时长:
接口地址:https://api.itapi.cn/api/ocr/idcard
返回格式:application/json
请求方式:HTTPSGET/POST
请求参数:
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 用户请求密钥,可在 密钥管理页面 申请 |
| data | string | 是 | 2M以内的图片base64编码数据 或 网络图片URL |
返回参数:
| 参数名称 | 类型 | 说明 |
|---|---|---|
| is_id_card | string | 是否为身份证 |
| match_score | string | 是否身份证的置信度 0~1 |
| side | string | front(正面)/ back(背面)/ both(正反面同框)/ unknown |
| fields | string | 结构化字段(未识别到为 null)——姓名 / 性别 / 民族 / 出生 / 住址 / 公民身份号码(正面),签发机关 / 有效期限(背面) |
| normalized | string | 号码按 GB 11643-1999(ISO 7064 MOD 11-2)校验位验证;出生日期归一化并计算周岁;性别由字段优先、缺省由号码第 17 位(奇男偶女)推出(gender_from_id);民族补“族”字并修正常见误识;region_code 为号码前 6 位行政区划码;有效期限拆出起止、是否“长期”、是否已过期 |
返回示例:
系统错误代码:
| 代号 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 限制或者错误 |
| 403 | 权限问题 |
| 500 | 服务器内部错误 |