服务主要功能描述
身份实名认证API(翔云),实时联网权威数据源,核验上传的姓名+身份证号(可以上传身份证图片系统自动识别)+上传的人脸图像与数据源内的身份证头像相似度,并返回人像比对相似度百分比值。
-
通过https协议post方法上传图像文件,通过https接口进行识别;
-
将核验结果以XML或json格式返回给用户;
4、服务调用约束
在调用身份实名认证标准版接口前,请您确保客户端程序或设备网络连接通畅,要求上传人像图片小于100kb。
接口说明
接口地址:https://netocr.com/verapi/veridenOrd.do
接口调用方法:post
3、请求参数
名称 类型 必填 说明
key String 是 用户ocrKey
secret String 是 用户ocrSecrert
trueName String 是 姓名
idenNo String 是 身份证号
img String 是 场景照片(JPG格式照片的Base64编码,编码后大小不能超过1M)
typeId Integer 是 身份实名认证标准版:3013
format String 是 返回格式(xml或者json),如果format为空,则默认返回xml
接口返回值参数说明
序号 名称 类型 说明
1 verify_result_status String 身份信息核验结果1:判定为同一人2:判定为不同人3:不确定是否为同一人4:姓名与身份号码不匹配5:库中无照片6:库中无此号7:图片不合格
2 verify_similarity String 比对值0 < verify_similarity < 40:判定为不同人40 ≤ verify_similarity ≤ 44:不确定是否为同一人45 ≤ verify_similarity:判定为同一人
状态码说明:
status code message
0 调用成功(扣费)
400 参数缺失
410 参数无法解析
420 传入参数错误
999 服务器错误
调用错误码
status值 描述
-1 用户已屏蔽
-2 用户key或secret验证错误
-3 服务次数不足
-4 用户未找到
-6 系统异常
-7 图片不可为空,参数不可为空
-8 类型错误
调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\,如图:
2.示例程序代码详见: \java客户端\httpClientDemo\中的Client类,如图:
在main方法定义参数,并传入 doPost(url, file, key, secret, typeId, format) 方法中。如图:
返回结果如下:
<?xml version='1.0' encoding='UTF-8'?><status>0</status>
<value>处理成功</value>
<Info>
<veritem desc="verify_result_status">2</veritem>
<veritem desc="verify_result_desc">判定为不同人</veritem>
<veritem desc="verify_similarity">9</veritem>
</Info>
{
“messageString”:{“status”:“0”,“value”:“处理成功”},
“infoList”:[
{
“veritem”:[
{“desc”:“verify_result_status”,“name”:null,“content”:“1”},
{“desc”:“verify_result_desc”,“name”:null,“content”:“判定为同一人”},
{“desc”:“verify_similarity”,“name”:null,“content”:“93”}
]
}
]
}