身份证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 }