198
云计算
负载均衡
产品简介
产品价格
快速入门
用户指南
实践操作
常见问题
购买指南
云服务器
产品简介
计费规则
购买指导
控制台使用指南
常见问题
云数据库
产品简介
计费规则
购买指导
快速入门
连接实例
控制台使用指南
对象存储
产品简介
控制台使用指南
程序员百科
Python
身份证识别(金融加密版)API接口介绍


身份证识别(金融加密版)API接口能力介绍

根据人民银行在《个人金融信息保护技术规范》中指出,身份证证件信息传输过程的参与方应当保证信息传输过程中的保密性、完整性和可用性,信息通过公共网络传输时,应使用加密通道或数据加密的方式进行传输。


点击申请百度智能云VIP客户,立即体验身份证识别>>>


能力介绍

根据人民银行在《个人金融信息保护技术规范》中指出,身份证证件信息传输过程的参与方应当保证信息传输过程中的保密性、完整性和可用性,信息通过公共网络传输时,应使用加密通道或数据加密的方式进行传输。

为保护个人身份证隐私信息不被窃取泄露,面向金融、支付机构等客户,推出身份证识别(金融加密版)接口,联手百度安全实验室,实现“一次一密”的金融级数据加密传输,能够有效防止信息泄露。

本身份证识别(加密版)接口的主要功能为:对用户身份证图片与识别结果进行加密,避免在数据传输过程中,身份证图片与其中的姓名、身份证号、住址等隐私数据被泄露,保护数据安全传输,免受恶意攻击。

接口说明

身份证识别(金融加密版)接口支持所有身份证识别接口的能力,并在此基础上,提供信息传输加密,身份证图片的加密与识别结果的解密操作需要在您的服务端完成。

支持对二代居民身份证正反面所有8个字段进行结构化识别,包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限,识别准确率超过99%;同时支持身份证正面头像检测,并返回头像切片的base64编码及位置信息。

同时,支持对用户上传的身份证图片进行图像风险和质量检测,可识别图片是否为复印件或临时身份证,是否被翻拍或编辑,是否存在正反颠倒、模糊、欠曝、过曝等质量问题。

为使您更好的使用本接口,我们提供了接入工具文件及工具使用文档,如有需要,请联系您的商务经理或 提交工单 联系我们。

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/ocr/v1/idcard_enc

URL参数:

参数
access_token通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header如下:

参数
Content-Typeapplication/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数是否必选类型可选值范围说明
imagestring-加密后的图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式
enc_aes_keystring-白盒加密后的AES key,请参照工具文件及工具使用文档,使用加密文件生成
id_card_sidestringfront/back- front:身份证含照片的一面
- back:身份证带国徽的一面
自动检测身份证正反面,如果传参指定方向与图片相反,支持正常识别,返回参数image_status字段为"reversed_side"
detect_riskstringtrue/false是否开启身份证风险类型(身份证复印件、临时身份证、身份证翻拍、修改过的身份证)功能,默认不开启,即:false。
- true:开启,请查看返回参数risk_type;
- false:不开启
detect_qualitystringtrue/false是否开启身份证质量类型(边框/四角不完整、头像或关键字段被遮挡/马赛克)检测功能,默认不开启,即:false。
- true:开启,请查看返回参数card_quality;
- false:不开启
detect_photostringtrue/false是否检测头像内容,默认不检测。可选值:true-检测头像并返回头像的 base64 编码及位置信息
detect_cardstringtrue/false是否检测身份证进行裁剪,默认不检测。可选值:true-检测身份证并返回证照的 base64 编码及位置信息

请求代码示例

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard_enc?access_token=【调用鉴权接口获取的token】' --data 'id_card_side=front&image=【图片Base64编码,需UrlEncode】&enc_aes_key=enc_aes_key' -H 'Content-Type:application/x-www-form-urlencoded'

返回说明

对返回结果解密后的结果信息与身份证识别一致,如下:
返回参数

字段是否必选类型说明
log_iduint64唯一的log id,用于问题定位
directionint32图像方向。
- - 1:未定义,
- 0:正向,
- 1: 逆时针90度,
- 2:逆时针180度,
- 3:逆时针270度
image_statusstringnormal-识别正常
reversed_side-身份证正反面颠倒
non_idcard-上传的图片中不包含身份证
blurred-身份证模糊
other_type_card-其他类型证照
over_exposure-身份证关键字段反光或过曝
over_dark-身份证欠曝(亮度过低)
unknown-未知状态
risk_typestring输入参数 detect_risk = true 时,则返回该字段识别身份证类型: normal-正常身份证;copy-复印件;temporary-临时身份证;screen-翻拍;unknown-其他未知情况
edit_toolstring如果参数 detect_risk = true 时,则返回此字段。如果检测身份证被编辑过,该字段指定编辑软件名称,如:Adobe Photoshop CC 2014 (Macintosh),如果没有被编辑过则返回值无此参数
card_qualityobject输入参数 detect_quality = true 时,则返回该字段识别身份证质量类型:
IsClear - 是否清晰;
IsComplete - 是否边框/四角完整;
IsNoCover - 是否头像、关键字段无遮挡/马赛克。
及对应的概率:IsComplete_propobility、IsClear_propobility、IsNoCover_propobility,值在0-1之间,值越大表示图像质量越好。
默认阈值(仅为推荐值,建议按照实际业务场景,基于图片返回的具体概率值,自定义设置判断阈值):当 IsClear_propobility、IsComplete_propobility 超过0.5时,对应IsClear、IsComplete 返回1,低于0.5,则返回0;
当 IsNoCover_propobility 超过0.3时,对应IsNoCover 返回1,低于0.3,则返回0
photostring当请求参数 detect_photo = true时返回,头像切图的 base64 编码(无编码头,需自行处理)
photo_locationarray[]当请求参数 detect_photo = true时返回,头像的位置信息(坐标0点为左上角)
card_imagestring当请求参数 detect_card = true时返回,身份证裁剪切图的 base64 编码(无编码头,需自行处理)
card_locationobject当请求参数 detect_card = true时返回,身份证裁剪切图的位置信息(坐标0点为左上角)
idcard_number_typestring用于校验身份证号码、性别、出生是否一致,输出结果及其对应关系如下:
-1: 身份证正面所有字段全为空
0: 身份证证号不合法,此情况下不返回身份证证号
1: 身份证证号和性别、出生信息一致
2: 身份证证号和性别、出生信息都不一致
3: 身份证证号和出生信息不一致
4: 身份证证号和性别信息不一致
words_resultarray[]定位和识别结果数组
words_result_numuint32识别结果数,表示words_result的元素个数
+ locationarray[]位置数组(坐标0点为左上角)
++ leftuint32表示定位位置的长方形左上顶点的水平坐标
++ topuint32表示定位位置的长方形左上顶点的垂直坐标
++ widthuint32表示定位位置的长方形的宽度
++ heightuint32表示定位位置的长方形的高度
+ wordsstring识别结果字符串


这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!