短信签名快速报备,马上注册寻求客户经理支持!
所有文档
文字识别
文档中心 > 文字识别 > 身份证OCR

身份证OCR


提交查询

1、接口描述

可识别身份证正、反面,正/反面需要分开请求

2、请求地址

https://api.ihuyi.com/ocr/idcard/Submit.json

3、请求头说明

参数名称 参数值描述 示例 类型 必填
Content-Type 内容类型,固定值 application/x-www-form-urlencoded string

4、请求参数说明

参数名称 参数值描述 示例 类型 必填
account APIID(用户中心【认证核验】-【OCR识别】-【产品总览】查看) xxxxxxxx string
password 1、APIKEY(用户中心【认证核验】-【OCR识别】-【产品总览】查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
xxxxxxxxx string
img_file 图片文件(multipart file,小于1MB,支持jpg、png、bmp) file
img_url 图片url(img_file、img_url二选一传递,小于1MB,支持jpg、png、bmp) string
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填) 1623643787 string

5、响应参数

参数名称 参数值描述 示例 类型 必返
code 返回值为2时,表示提交成功 2|1 int
msg 提交结果描述 提交成功|提交失败 string
idcardid 当提交成功后,此字段为流水号,否则为0或空 16236437872836|0 string
result 识别结果 object
info[] 数据 array
name 姓名 林** string
idcard 身份证号 350*************59 string
sex 性别 string
nation 民族 string
birthday 生日 19**年12月16日 string
address 地址 福建省**市**镇***路东**号 string
authority 签发机关 北京市公安局西城分局 string
timelimit 有效期限 2004.10.27-2024.10.26 string

6、响应状态码说明

code msg
0 未知错误
1 提交失败
2 提交成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
403 应用不存在
405 API ID 或 API KEY 不正确
4050 账号被冻结
40501 动态密码已过期
40502 动态密码校验失败
40505 没有签定合同
4051 剩余条数不足
4052 访问 ip 与备案 ip 不符
4086 通道无效
4010 通道错误
4201 查询失败
4202 图片识别失败
4301 img_file、img_url不能同时为空
4302 上传图片大小必须控制在5KB-1MB之间
4303 上传图片格式不正确,只支持bmp,jpg,jpeg,png
4304 上传图片失败

7、GET传参示例

https://api.ihuyi.com/ocr/idcard/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&img_file=&img_url=&time=1623643787

8、响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><info><list><name>林**</name><idcard>350*************59</idcard><sex>男</sex><nation>汉</nation><birthday>19**年12月16日</birthday><address>福建省**市**镇***路东**号</address><authority>北京市公安局西城分局</authority><timelimit>2004.10.27-2024.10.26</timelimit></list><list><name>林**</name><idcard>350*************59</idcard><sex>男</sex><nation>汉</nation><birthday>19**年12月16日</birthday><address>福建省**市**镇***路东**号</address><authority>北京市公安局西城分局</authority><timelimit>2004.10.27-2024.10.26</timelimit></list><list><name>林**</name><idcard>350*************59</idcard><sex>男</sex><nation>汉</nation><birthday>19**年12月16日</birthday><address>福建省**市**镇***路东**号</address><authority>北京市公安局西城分局</authority><timelimit>2004.10.27-2024.10.26</timelimit></list></info></result></SubmitResult>
{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                    [    {    "name":
            "林**"
        ,        "idcard":
            "350*************59"
        ,        "sex":
            "男"
        ,        "nation":
            "汉"
        ,        "birthday":
            "19**年12月16日"
        ,        "address":
            "福建省**市**镇***路东**号"
        ,        "authority":
            "北京市公安局西城分局"
        ,        "timelimit":
            "2004.10.27-2024.10.26"
                }
    ,        {    "name":
            "林**"
        ,        "idcard":
            "350*************59"
        ,        "sex":
            "男"
        ,        "nation":
            "汉"
        ,        "birthday":
            "19**年12月16日"
        ,        "address":
            "福建省**市**镇***路东**号"
        ,        "authority":
            "北京市公安局西城分局"
        ,        "timelimit":
            "2004.10.27-2024.10.26"
                }
    ,        {    "name":
            "林**"
        ,        "idcard":
            "350*************59"
        ,        "sex":
            "男"
        ,        "nation":
            "汉"
        ,        "birthday":
            "19**年12月16日"
        ,        "address":
            "福建省**市**镇***路东**号"
        ,        "authority":
            "北京市公安局西城分局"
        ,        "timelimit":
            "2004.10.27-2024.10.26"
                }
        ]
            }
                }

示例(失败)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>提交失败</msg></SubmitResult>
{"code":1,"msg":"提交失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'idcard'; //固定值
$time = '1623643787';
$password=md5($account.$password.$app.$time);
$password=md5('xxxxxxxxxxxxxxxxxidcard1623643787');

//注意:所有字符编码统一为UTF-8

10、代码示例

在线咨询
服务热线:
4008 808 898

免费体验

提交成功
若短信发送异常,系统将自动给您发送语音验证码,请注意接听电话。

填写验证码后,点击“开通体验账户”自动开通体验账户。

收不到短信验证码?
×