接口状态: | 正常 |
---|---|
识别类型: | 证照OCR |
申请API数: | 14245 |
详情描述: | 通过提交身份证图片内容,识别身份证内容 |
身份证识别分为普通版和切图版,普通版返回正常的识别结果,切图版在普通版基础上多返回两个字段,即经过切边处理后的身份证图片和头像图片
普通版:http(s)://api.hanvon.com/rt/ws/v1/ocr/idcard/recg?key=yourKey&code=8d497db3-7341-4f1f-875a-2f5444884515
切图版:http(s)://api.hanvon.com/rt/ws/v1/ocr/idcard/cropped/recg?key=yourKey&code=56bc30ea-2229-4891-9c92-8a022f10889f
key:请到开发中心-->应用管理-->Key管理,在您的Key列表中找到对应的Key
code:code为固定值,直接使用url中的code即可
字段 | 描述 |
---|---|
uid | 您的服务器IP地址。 |
image | 身份证图像的base64串,图片要求为真彩色,不要进行灰度处理 |
<?php //定义请求的url地址 $url = "http://api.hanvon.com/rt/ws/v1/ocr/idcard/recg?key=your_android_key&code=8d497db3-7341-4f1f-875a-2f5444884515"; //模拟发送POST请求(CURL四步走) //第一步:初始化curl $ch = curl_init(); //第二步:设置相关参数 //设置请求的url地址 curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); //禁止SSL证书的校检功能 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //模拟发送POST请求 curl_setopt($ch, CURLOPT_POST, 1); $image=base64_encode(file_get_contents('1.jpg')); var_dump($image); $arr = array ('uid'=>'0.0.0.0','image'=>$image); $data = json_encode($arr); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); //第三步:执行curl $output = curl_exec($ch); //判断输出结果是否异常 if($output===false) { echo curl_error($ch); } else { var_dump($output); } //第四步:关闭curl curl_close($ch); ?>
字段 | 父字段 | 描述 |
---|---|---|
code | response | code |
result | response | result |
name | response | 姓名 |
gender | response | 性别 |
people | response | 民族 |
byear | response | 出生年 |
bmonth | response | 出生月 |
bday | response | 出生日 |
address | response | 住址 |
idnumber | response | 公民身份证号 |
authority | response | 签发机关 |
validdate | response | 有效期限 |
left | response | 身份证头像左边距 |
top | response | 身份证头像上边距 |
right | response | 身份证头像右边距 |
bottom | response | 身份证头像下边距 |
croppedImage | response | 身份证切割图的base64串(仅切图版有值) |
headImage | response | 身份证头像图片的base64串(仅切图版有值) |
Success:
Failure:
1. 身份证尽可能充满整个画面。
2. 拍摄时,请保持光线充足,不要有阴影和反光。
3. 请对焦后进行拍摄,尽量避免抖动。
4. 为提高识别率,身份证最少200万像素以上,即2000*1000以上。
4. 识别的身份证图片需为正常的图片,不能是灰度图片。