首页 > 身份证核对接口 > 身份证OCR识别
身份证OCR识别

身份证OCR识别

限个人认证或企业认证使用

支持对二代居民身份证正反面所有8个字段进行结构化识别。

次数包
产品价格
-
次数包自购买之日起1年有效 , 按量付费价格如果有变化提前30天短信通知

服务提示

请勿线下交易!90%的欺诈、纠纷、资金盗取均由线下交易导致。

联系客服
官网:
客服QQ:
89932950 iP138.com客服
联系电话:
0592-5938055

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

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


请求字段说明:

参数是否必选类型可选值范围说明
image和url二选一string-图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式
url和image二选一string-图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式,当image字段存在时url字段失效
请注意关闭URL防盗链
id_card_sidestringfront/back-front:身份证含照片的一面
-back:身份证带国徽的一面
自动检测身份证正反面,如果传参指定方向与图片相反,支持正常识别,返回参数image_status字段为"reversed_side"


字段返回说明:

字段是否必选类型说明
log_iduint64唯一的log id,用于问题定位
words_resultarray[]定位和识别结果数组
words_result_numuint32识别结果数,表示words_result的元素个数
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、IsNoCover_propobility、IsClear_propobility,值在0-1之间,值越大表示图像质量越好。
默认阈值:当 IsComplete_propobility 超过0.5时,IsComplete返回1,低于0.5,则返回0。IsNoCover_propobility、IsClear_propobility 同上
photostring当请求参数 detect_photo = true时返回,头像切图的 base64 编码(无编码头,需自行处理)
photo_locationobject当请求参数 detect_photo = true时返回,头像的位置信息(坐标0点为左上角)
card_imagestring当请求参数 detect_card = true时返回,身份证裁剪切图的 base64 编码(无编码头,需自行处理)
card_locationobject当请求参数 detect_card = true时返回,身份证裁剪切图的位置信息(坐标0点为左上角)
idcard_number_typeint用于校验身份证号码、性别、出生是否一致,输出结果及其对应关系如下:
- 1: 身份证正面所有字段全为空
0: 身份证证号不合法,此情况下不返回身份证证号
1: 身份证证号和性别、出生信息一致
2: 身份证证号和性别、出生信息都不一致
3: 身份证证号和出生信息不一致
4: 身份证证号和性别信息不一致
locationarray[]位置数组(坐标0点为左上角)
leftuint32表示定位位置的长方形左上顶点的水平坐标
topuint32表示定位位置的长方形左上顶点的垂直坐标
widthuint32表示定位位置的长方形的宽度
heightuint32表示定位位置的长方形的高度
wordsstring识别结果字符串


身份证识别

接口地址:http(s)://分配的二级域名/ocr/idcard

请求方式:POST

平台参数
名称 位置 必填 示例 说明
token query / header abcdefghijklmnopqrstuvwxyz012345 用户中心 -> 我的API 中获取
请求参数
名称 位置 必填 示例 说明
url post 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式,当image字段存在时url字段失效 请注意关闭URL防盗链
image post 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式
id_card_side post front front:身份证含照片的一面、back:身份证带国徽的一面
detect_risk post false 是否开启身份证风险类型(身份证复印件、临时身份证、身份证翻拍、修改过的身份证)检测功能,默认不开启,即:false。

返回成功示例

{"words_result":{"失效日期":{"location":{"top":379,"left":461,"width":100,"height":28},"words":"20350206"},"签发机关":{"location":{"top":335,"left":348,"width":120,"height":29},"words":"厦门市公安局"},"签发日期":{"location":{"top":381,"left":347,"width":100,"height":28},"words":"20150206"}},"words_result_num":3,"image_status":"reversed_side","log_id":1625058880770910187}

产品服务协议

欢迎您使用【身份证识别】。

本产品服务最终用户协议(“本协议”)是您(“用户”)和【厦门市常量科技有限公司】(“服务商”)之间,就服务商为您提供【身份证识别】(“本服务”),所达成的合法协议。


一、协议的生效

1.  用户确认而生效:本协议由服务商提供在线版本,用户购买本服务后视为已阅读并同意本协议,即具有合同效力,对服务商和用户具有法律约束力。

2.  用户使用而生效:用户可以通过API云市场使用本服务。服务商会在相应环节提供本协议的在线版本供用户阅读。一旦用户以任何一种方式使用本服务,即表示用户已同意接受本协议中的所有条款。如果用户不接受本协议中的条款,请不要使用本服务。


二、定义

身份证识别】是指当前你购买的此产品服务


三、使用许可

1.  本服务受版权法、国际版权条约以及其他相关的知识产权法律、法规和条约的保护。本软件产品|服务为授权用户使用许可,而非出售。

2.  本服务的所有权归【厦门市常量科技有限公司】所有。

3.  根据本协议的约定,服务商授予用户一项非排他的、不可转让的使用本服务的使用许可。用户不得转售或以其他方式转让本使用许可权利以牟取商业利益。


四、费用:

1.  服务商同意,目前向用户免费提供本服务的使用许可。但该免费服务,不应视为服务商放弃在未来某一时刻开始收费的权利。未来服务商如对用户就本服务收取许可费用,将通过相关网页、购买环节等明示告知用户。

2.  用户使用本服务须按照本服务的价格体系、支付所有费用。服务商保留在用户未按照约定支付全部费用之前不向用户提供服务和|或技术支持,或者终止服务和|或技术支持的权利。

3.  用户如对本服务进行续费时,本服务的名称、规格或价格已经调整的,用户同意按照届时有效的新的本服务的名称、规格或价格履行;用户不同意新的本服务的名称、规格或价格的,可不进行续费,本服务到期后自动终止。


五、用户的权利义务

1.  用户保证其使用本服务的各项行为均符合国家法律法规的规定,合法真实且不侵害任何第三方的合法权益。

2.  用户应按时足额支付本服务的费用(如有),否则服务商保留随时终止用户使用本服务的权利,用户应对服务商终止本服务而可能造成的损害自行承担全部责任。

3.  用户保证,除且仅除法律明确允许的活动以外,用户不得逆向工程、反编译或反汇编本服务。

4.  用户理解并同意,

(1)因现有技术限制,服务商提供的本服务可能存在瑕疵,并不能保证在任何情况下都能正常执行或达到用户所期望的结果。

(2)因用户使用本服务所致的任何损害,用户同意服务商的最高赔偿限额为100元。


六、服务商的权利义务

1.  服务商保证,其有合法权利向用户提供本服务的使用许可,并保证其版权的合法性。

2.  服务商承诺,其向用户提供本服务之行为未对任何第三方合法权益,包括但不限于第三方知识产权构成侵害。如因其行为导致用户遭受任何第三方提起的法律诉讼或行政程序(“侵权指控”),服务商承担其法律责任及后果。

3.  服务商负责及时对本服务进行升级、维护和管理,并通过客服电话、在线客服等方式,向用户提供免费的咨询及技术支持服务。

4.  服务商承诺,保证其为用户提供的本服务的稳定性和延续性。如因服务商原因,导致用户对于本服务的使用许可需提前终止的,服务商应对用户履行相应的退款义务(如有)。如因此给用户造成损失的,服务商应承担全额的赔偿责任。

5.  服务商承诺,其向用户提供的本服务中不含有:

(1)蓄意毁坏、恶意干扰、秘密地截取或侵占任何系统、数据或个人资料的任何病毒、伪装破坏程序、电脑蠕虫、定时程序炸弹或其他电脑程序;

(2)任何已知的漏洞、后门、恶意软件;

(3)其他可能对用户的系统安全造成损害的不安全内容。

6.  责任限制:在适用法律所允许的最大范围内,服务商不会对因使用或不能使用本服务所引起的或有关的任何间接的、意外的、直接的、特殊的、惩罚性的或其它任何损害(包括但不限于因人身伤害或财产损坏而造成的损害,因利润损失、数据损失、营业中断、计算机瘫痪或故障、商业信息的遗失而造成的损害,因未能履行包括诚信或相当注意在内的任何责任致使隐私泄露而造成的损害,因疏忽而造成的损害,或因任何金钱上的损失或任何其它损失而造成的损害)承担赔偿责任,即使服务商事先被告知该损害发生的可能性。


七、用户数据的使用和披露

1.  为服务用户的目的,服务商可能通过使用用户数据,向用户提供服务,包括但不限于向用户发出产品和服务信息。

2.  用户保证数据内容仅在用户本公司内自运营项目使用(不包含子公司、分公司、投资公司、联运项目等),不得将乙方所给予的数据更新接口或者网站用户账号密码对外公开或者交予其它第三方使用。

3.  用户保证用户的数据仅存在于用户的数据中心所在服务器以及内部网络所在服务器当中,不得以任何形式将部分或者全部数据直接或者间接放置于任何软件、客户端或者移动互联网应用当中。如需使用,只能以服务器接口形式进行使用,并且要进行最大限度的限速或者加密处理,避免被其它第三方利用。

4.  未经用户许可,服务商不会擅自披露用户数据。但在下述情况下,用户数据将部分或全部被披露:

(1)经用户同意,向第三方披露;

(2)根据法律的有关规定,或者行政或司法机构的要求,向第三方或者行政、司法机构 披露;

(3)如果用户出现违反中国有关法律法规的情况,需要向第三方披露;

(4)为提供用户所要求的软件或服务,而必须和第三方分享用户数据。 


八、期限与终止

1.  本服务的期限为12个月(以用户购买的产品周期为准)。

2.  出现下列情况之一的,服务商有权终止继续提供本服务,而无需承担任何责任:

(1)用户购买的本服务已到期且未续费的;

(2)用户严重违反本协议项下条款的约定,且自服务商通知其纠正后仍未纠正的。 


九、协议修改

1.  如果本协议的任何内容发生变动,服务商应通过适当方式向用户提示修改内容。

2.  如果用户不同意服务商对本协议相关条款所做的修改,用户有权停止使用本服务。此等情况下,服务商应向用户退回剩余费用(如有),并在终止服务前给予用户一定的合理期限,进行数据备份、下载、保存、迁移及其他必要工作。如用户继续使用本服务,则视为用户接受服务商对本协议相关条款所做的修改。


十、法律及争议解决

1.  本协议的订立、执行和解释及争议的解决均应适用【中华人民共和国法律】。

2.  因双方就本协议的签订、履行或解释发生争议,双方应努力友好协商解决。如协商不成,任何一方均应向被告所在地人民法院起诉。


十一、附则

1.  如本协议的任何条款被视作无效或无法执行,则上述条款可被分离,其余部分则仍具有法律效力。

2.  本协议的标题仅为方便阅读所设,非对条款的定义、限制、解释或描述其范围或界限。

3.  服务商可根据其自身运营状况,在提前30个工作日通知用户的前提下,将其在本协议项下的权利义务全部转让给第三方,而无需获得用户的事先同意。服务商之受让人受本协议约束,服务商与其受让人对本协议的履行承担连带责任。