识别身份证识别

OCR(印尼身份证检测)URLhttps://api-idn.
megvii.
com/faceid/v3/indonesia_ocr_sdk/ocr请求方式post描述印尼身份证识别接口,通过印尼身份证质量检测SDK获取的加密数据调用此接口将数据传到我方Server进行解密,解密后获取身份证照片、大头照以及对应的OCR信息;参数必选/可选参数类型说明必选ocr_dataFile包含客户加密后的身份证照片、大头照(若客户设置大头照区域模糊度不够时依然检出,则可能没有大头照),使用muPostMultipart/Form-Data方式上传必选biz_tokenString本次业务的biz_token可选biz_noString本次业务的业务流水号出参:参数类型参数说明resultint表示识别的可能的结果:(如图片中有多张证件,只返回证件号confidence值最高的一张证件信息)1001:表示识别出一张没有问题的身份证并返回证件并返回证件内容;(正常识别)1002:表示识别出一张身份证并返回证件内容,但是证件号或姓名未识别出来;(正常识别且有质量问题)1003:表示识别出一张身份证但只返回身份证图片及大头照,不返回证件内容(只提供质量检测,不识别)2001:表示未识别出身份证或其它异常导致的未能返回身份证照片及证件信息(未能识别)biz_noString传入的业务流水号,原封不动地返回request_idString用于区分每一次请求的唯一的字符串.
除非发生404(API_NOT_FOUND)或403(AUTHORIZATION_ERROR)错误,剩余情况此字段必定返回.
idcard_imageString解密后的身份证照片,Base64编码idcard_face_imageString解密后的身份证上大头照,Base64编码issued_provinceDict发卡省,需要识别才返回;issued_cityDict发卡市,需要识别才返回;idcard_numberDict证件号,需要识别才返回;nameDict姓名,需要识别才返回;birth_placeDict出生地,需要识别才返回;birthdayDict出生日期,需要识别才返回;genderDict性别,需要识别才返回;blood_typeDict血型,需要识别才返回;address_areaDict地址,需要识别才返回;address_buildingDict单元、楼号;需要识别才返回;address_quartersDict小区,需要识别才返回;address_districtsDict街道,需要识别才返回;faithDict宗教信仰,需要识别才返回;marriage_typeDict婚姻状态,需要识别才返回;professionDict职业,需要识别才返回;nationalityDict国籍,需要识别才返回;valid_endDict有效期,需要识别才返回;issued_areaDict发卡地(头像下地区信息),需要识别才返回;valid_startDict签发时间,需要识别才返回;legalityDict【预留】表示对身份证照片的分类的结果.
它为一个结构体,包含3个key-valuepair,每个key表示一种分类类型,每个value为此类型的概率值(取[0,1]区间实数,取3位有效数字,3个value总和为1).
这3个key是:ID_Photo:真实身份证照片Photocopy:正式身份证的复印件Screen:手机或电脑屏幕翻拍的照片ID_Photo_Threshold:表示判断为正式身份证照片的阈值,通常来说,如果ID_Photo的值不低于该阈值,可以认定为真实身份证的实拍;card_rectDict【预留】结构体返回,包含整张卡片四点坐标ERRORString发生错误后,会返回对应的错误码,具体见下面ERROR错误信息结构体+resultString识别到的对应内容,若没有识别到,则返回空字符串;+confidenceFloat表示置信度,值为一个[0,100]的浮点数,小数点后3位有效数字;+qualityFloat【预留】表示该区域是否存在质量问题(存在影响识别的光斑、阴影、遮挡、污渍等),注意:存在质量问题如果是光斑,部分遮挡,也是可以识别出内容的,本字段对存在留存需求的场景提供参考.
取[0,1]区间实数,3位有效数字,一般来说,这个质量分低于***,我们认为存在质量问题.
+logicInt【预留】表示该字段是否存在逻辑问题0:表示正常;1:表示存在逻辑问题;+rectDict【预留】字典结构,里面会包含区域的四点坐标特殊的ERRORHTTP状态代码错误信息说明400ID_CARD_NOT_FOUND图片中没有找到身份证.
ERROR错误信息HTTP状态代码错误信息说明404API_NOT_FOUND所调用的API不存在.
403AUTHENTICATION_ERRORapi_key和api_secret不匹配.
HTTP状态代码错误信息说明403AUTHORIZATION_ERROR:api_key被停用、调用次数超限、没有调用此API的权限,或者没有以当前方式调用此API的权限.
取值:5001:api_key无权限或被停用5007:这个api_key对当前API的调用量达到上限.
仅当api_key为测试key400BAD_ARGUMENTS:某个参数解析出错(比如必须是数字,但是输入的是非数字字符串;或者长度过长,或者照片无法解析)403CONCURRENCY_LIMIT_EXCEEDED并发数超过限制500INTERNAL_ERROR服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系FaceID客服或商务.
400MISSING_ARGUMENTS:缺少某个必选参数.
413RequestEntityTooLarge客户发送的请求大小超过了20MB限制或单张照片大小超过了2MB.
该错误的返回格式为纯文本,不是json格式.