|
一、接口简介
1、版权说明：
未经翔云人工智能开放平台授权，不得擅自进行使用。
2、调用客户端运行环境
当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。
3、服务主要功能描述
翔云身份证实名认证增强版服务，实时联网权威数据源，核验上传的姓名+身份证号（可以上传身份证图片系统自动识别）+上传的身份证图像中头像与数据源内的身份证头像相似度，并返回人像比对相似度百分比值。
- 通过https协议post方法上传图像文件，通过https接口进行识别；
- 将核验结果以XML或json格式返回给用户；
4、服务调用约束
在调用身份证实名认证增强版接口前，请您确保客户端程序或设备网络连接通畅，要求上传人像图片小于100kb。
二、前提准备
1、用户登录 https://www.netocr.com/register.html注册账号，如图:
2、输入注册信息，确认无误后点击同意条款并注册，如图:
3、注册成功后点击右上角的账号名称-个人中心，进入管理页面:
4、点击“用户管理-基础信息”，查看OCRKey以及OCRSecret：
5、点击“服务列表”，查看服务次数及余额(每调用一次https接口消耗一次)，可点击立即购买直接跳转到购买页面购买API服务次数：
6、购买成功后,会显示购买的总次数及剩余次数，例如下图所示：
7、设置剩余条数提醒，进入个人中心-用户管理-剩余条数提醒，设置提醒下线、通知手机号及服务类型，设置成功后到达用户设置的服务剩余条数下限，系统会发短息至预留手机号。
三、接口说明
接口地址：https://netocr.com/verapi/veriden.do
接口调用方法：post
3、请求参数
名称 类型 必填 说明
key String 是 用户ocrKey
secret String 是 用户ocrSecrert
trueName String 是 姓名
idenNo String 是 身份证号
img String 是 身份证件照（JPG格式照片的Base64编码，编码后大小不能超过100kb）
typeId Integer 是 身份证实名认证增强版：3003
format String 是 返回格式(xml或者json)，如果format为空，则默认返回xml
接口返回值参数说明
名称 类型 说明
user_check_result String 身份信息核验结果
1：库中无此号
2：姓名及身份证号不一致
3：姓名及身份证号一致
4：核查失败
verify_result String 比对值
0：表示认为是同一人
1：表示认为不是同一人
verify_similarity String 对比相似值
分数取值范围 0 – 100, 值越大越相似
阈值是45
状态码说明：
status code message
0 调用成功（扣费）
4 核查失败
6 身份核查服务异常
调用错误码
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'?> 0 比对服务处理成功 3 姓名及身份证号一致 0 身份证信息为真 89.61351221698294
剩余条数查询接口(所有产品类型)
接口地址： https://netocr.com/api/accountLift.do
接口调用方法： post
接口接收参数：
String key： 用户ocrKey
String secret： 用户ocrSecret
String format： 返回格式(xml或者json)，如果format为空，则默认返回xml
|