身份证OCR识别正常
传入身份证照片,识别照片文字信息并返回,包括姓名、身份证号码、性别、民族、出生年月日、地址、签发机关及有效期等文本信息。支持各类图片URL和Base64数据。
调用次数
5 次
请求频率限制
5 次/秒
计费单价
30点/次(≈0.03元/次)
API文档
接口调试
接口地址
https://api.29783.com/ocr/identity-card 复制
返回格式
JSON
请求方式
HTTPSGETPOST
Header参数
| 名称 | 类型 | 必须 | 示例值 | 说明 |
|---|---|---|---|---|
| id | String | 是 | 您自己的Api ID(注册登录后在秘钥管理中获得) | 是 |
| key | String | 是 | 您自己的Api Key(注册登录后在秘钥管理中获得) | 是 |
请求参数
| 名称 | 类型 | 必须 | 示例值 | 说明 |
|---|---|---|---|---|
| image_url | String | 可选 | 图片/PDF文件的URL链接(二选一输入),优先解析image_base64 | |
| image_base64 | String | 可选 | 图片/PDF文件,base64编码(二选一输入),类似data:image/png;base64的图片头不要传入 |
返回参数
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| 返回结果公共参数 | |||
| code | Number | 0 | 接口返回状态码,0为成功 |
| message | String | 成功 | 接口返回文本信息 |
| data | Object/Array | 返回结果数据集/数组 | |
| request_ip | String | 123.152.251.58 | 请求接口的终端IP |
| request_time | Number | 1719145459 | 接口请求时间(默认为时间戳) |
| 返回结果数据集 | |||
| front | Object | {} | 身份证正面信息(不含正面是为空) |
| name | String | 韦小宝 | 姓名 |
| gender | String | 男 | 性别 |
| ethnicity | String | 汉 | 民族 |
| data_of_birth | String | 1965.12.20 | 出生日期 YYYY.MM.DD |
| id_number | String | 11204419651220243X | 公民身份号码 |
| domicile | String | 北京市东城区景山前街4号 | 住址 |
| back | Object | {} | 身份证反面信息(不含反面是为空) |
| issue_authority | String | 东城区公安局 | 签发机关 |
| valid_period | String | 2022.04.22-2042.04.22 | 有效期限(YYYY.MM.DD-YYYY.MM.DD) |
| quality | String | 正常 | 身份证图像质量 |
返回实例
{
"code": 0,
"message": "成功",
"data": {
"front": {
"name": "韦小宝",
"gender": "男",
"ethnicity": "汉",
"data_of_birth": "1965.12.20",
"id_number": "11204419651220243X",
"domicile": "北京市东城区景山前街4号"
},
"back": {
"issue_authority": "东城区公安局",
"valid_period": "2022.04.22-2042.04.22"
},
"quality": "正常"
},
"request_ip": "2408:8240:2811:eea0:45d9:4c81:6c1c:8078",
"request_time": 1722910296
}