# 识蛛云服务 Java SDK
普通Java sdk,未使用http连接池
# 下载 SDK
下载地址
点击立即下载实名认证 Java SDK# 添加到本地仓库
如果是非maven形式项目,直接将jar包放入Dependencies依赖目录
如果是maven项目,可在终端窗口执行以下命令安装到本地仓库:
Linux & Mac:
mvn install:install-file -Dfile=jar文件绝对路径 \
-DgroupId=cn.unitid.realidentity \
-DartifactId=openapi-java-sdk \
-Dversion=版本号 \
-Dpackaging=jar
mvn install:install-file -Dfile=jar文件绝对路径 \
-DgroupId=cn.unitid.easypki \
-DartifactId=jce \
-Dversion=1.0.1-RELEASE \
-Dpackaging=jar
Windows:
mvn install:install-file -Dfile=jar文件绝对路径 -DgroupId=cn.unitid.realidentity -DartifactId=openapi-java-sdk -Dversion=版本号 -Dpackaging=jar
mvn install:install-file -Dfile=jar文件绝对路径 -DgroupId=cn.unitid.easypki -DartifactId=jce -Dversion=1.0.1-RELEASE -Dpackaging=jar
然后在Maven项目pom文件中添加依赖:
<dependency>
<groupId>cn.unitid.realidentity</groupId>
<artifactId>openapi-java-sdk</artifactId>
<version>版本号</version>
</dependency>
<!-- 发证生成P10需要如下依赖 -->
<dependency>
<groupId>cn.unitid.easypki</groupId>
<artifactId>jce</artifactId>
<version>1.0.1-RELEASE</version>
</dependency>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk15on</artifactId>
<version>1.61</version>
</dependency>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcmail-jdk15on</artifactId>
<version>1.60</version>
</dependency>
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.14</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.6</version>
</dependency>
# 开启关闭sdk错误日志
//开启日志
ApiLogger.setNeedEnableLogger(true);
//关闭日志
ApiLogger.setNeedEnableLogger(false);
# 身份证件号码15位支持
由于核验中心只支持二代身份证件核验 因此对于旧有的15位证件号码需要根据规则转换为18位使用
以下示例以java版本SDK(v1.8.1开始支持):
方法1. 全局开启15位证件号码转换
DefaultApiClient.enabledIdcard15To18();
方法2. 手动使用15位证件号码转换工具类 (推荐)
String idcard15 = "15位证件号码";
String idcard18 = Utils.transformIdcard15to18(idcard15);
# SDK 版本变动记录
# 2023-10-24 (1.18.0)
该版本升级内容
- 实人认证时间戳/数字证书服务API增加属性score3,具体属性区间见api文档
# 2023-02-16 (1.17.0)
该版本升级内容
请求参数:
- 手机号实名核验请求参数
realname
、idcard
、phone
支持加密 - 银行卡四元素核验请求参数
realname
、idcard
、phone
、bankcard
支持加密 - 企业四要素核验请求参数
idcard
支持加密 - H5活体实名核验-H5活体实名核验请求参数
attr.realname
、attr.idcard
支持加密 - 视频活体实名核验请求参数
realname
、idcard
、videoData
支持加密 - 实名身份时间戳/数字证书服务API请求参数
realname
、idcard
支持加密 - 实人认证时间戳/数字证书服务API请求参数
realname
、idcard
、image
支持加密 - OCR识别服务请求参数
image
支持加密
响应参数:
- OCR识别服务响应参数
info
支持加密
其他:
- 依赖包 cn.unitid.easypki.jce 升级为 1.0.16-SNAPSHOT,请注意更新依赖
- 增加SM4加解密工具类: Sm4Utils、SecretGenerateUtils
# 2022-11-22 (1.16.0)
该版本升级内容
- 添加公共请求参数
encMethod
# 2021-12-31 (1.15.0)
该版本升级内容
- 实人认证时间戳/数字证书服务API增加属性score2,score属性区间改变为score2的区间,具体属性区间见api文档
// 代码修改示例: score 分数判定改完 0.6
IdcardDetectionFaceRequest req = new IdcardDetectionFaceRequest();
// ...
IdcardDetectionFaceResponse response = apiClient.execute(req);
if (response.isSuccess() && null != response.getData()) {
IdcardDetectionFaceResponse.Result data = response.getData();
// incorrect 等于 100,比对成功,后续判断分数是否为同一人
if (data.getIncorrect() == 100) {
// sdk 版本 1.15.0 前(不包含1.15.0)
// if (data.getScore() >= 0.45) {
// // todo 系统判断为一人
// }
// sdk 版本 1.15.0及以上, score 与score2一致,变更为0.6以上为同一人
if (data.getScore() >= 0.6) {
// todo 系统判断为一人
}
}
}
# 2021-10-15 (1.14.0)
该版本升级内容
- 添加企业打款认证接口和相关测试方法,文档
- H5活体实名核验获取认证会话接口
attr
修改为必填
# 2021-02-01 (1.13.0)
该版本升级内容
- 优化核验相关API的事件证书支持
# 2020-08-14 (1.12.0)
该版本升级内容
- 添加移动端在线活体验证接口和相关测试方法,文档
# 2020-04-17 (1.11.0)
该版本升级内容
- 基础文档-》API错误码说明:添加身份未认证等四个返回码
- 添加企业,个人发证六个接口和相关测试方法,文档
# 2019-12-30 (1.10.1)
该版本升级内容
- 添加企业四要素核验接口和相关测试方法,文档
# 2019-12-27 (1.10.0)
该版本升级内容
- OCR识别支持单张正反面
- 添加企业三要素核验接口和相关测试方法,文档
- 添加企业工商基础信息接口和相关测试方法,文档
- 添加企业工商信息接口和相关测试方法,文档
- 添加企业工商详细信息接口和相关测试方法,文档
- 添加企业信息列表接口和相关测试方法,文档
# 2019-08-05 (1.9.0)
该版本升级内容
- 添加可信时间戳接口和相关测试方法,文档
- 添加可信事件证书和相关测试方法,文档
- 新增时间戳和事件证书相关参数说明
# 2019-06-12 (1.8.1)
该版本升级内容
- 添加15位证件号码转换功能
# 2019-04-30 (1.8.0)
该版本升级内容
- ocr识别添加是否返回人脸截图
# 2019-04-15 (1.7.0)
该版本升级内容
- 添加银行卡四元素核验接口,相关测试方法,文档
- 人脸比对返回码添加详细说明
- 文档返回码添加收费说明
# 2019-03-08 (1.6.0)
该版本升级内容
- 添加人脸图片比对接口,相关测试方法,文档
- 静态活体认证至少上传两张图片
- 视频活体实名核验:返回码130描述,由“视频活体检测成功,未进行身份核验,人脸比对失败”改为“视频活体检测成功,照片质量不合格,未进行人脸比对”
# 2019-01-31 (1.5.0)
该版本升级内容
- 添加身份多项核验、人脸图片裁剪接口,相关测试方法,文档
# 2018-12-24 (1.4.6)
该版本升级内容
- 添加h5视频检测相关接口,测试方法,文档
- 修复静态活体认证返回值List为空问题解决
# 2018-12-13 (1.4.5)
该版本升级内容
- 返回值List为空问题解决
# 2018-12-12 (1.4.4)
该版本升级内容
- 添加自动重试客户端,修改相关测试方法,文档
- 视频vedio改成video接口和相关测试方法,文档修改
# 2018-11-21 (1.4.0)
该版本升级内容
- 静态活体认证接口上传图片类型url:替换为fs:,修改相关测试方法,文档
- 添加获取文件上传权限接口和相关测试方法,文档
- 添加下载应用账单接口和相关测试方法,文档
- 添加视频活体实名认证接口和相关测试方法,文档
- 添加视频活体检测接口和相关测试方法,文档
- 添加OCR图片识别接口和相关测试方法,文档
- 添加图片处理测试方法
- 去除控件活体检测IdcardLiveness,该方法已经下架
- 人脸比对返回码修改
# 2018-09-27 (1.3.2)
该版本升级内容
- 修复去除\n字符导致的问题
# 2018-09-19 (1.3.1)
该版本升级内容
- 添加图片BASE64字符串时去除\n字符
# 2018-09-13 (1.3.0)
该版本升级内容
- 添加静态活体认证接口和相关测试方法,文档
- 人脸比对添加非必填字段,质量控制,修改相应方法,文档
# 2018-08-01(1.2.0)
该版本升级内容:
- 人脸识别添加scoreMsg(分数建议),返回码添加102,107,108
# 2018-06-08(1.1.1)
该版本升级内容:
- 响应参添加状态码incorrect,修改相应文档
- 添加账户余额查询接口
# 2018-06-07(1.0.3)
该版本升级内容:
- 活体检测添加非必填参数isH5,修改测试用例
# 2018-04-23(1.0.2)
该版本升级内容:
- API调用协议:响应参数添加requestId做唯一标识,错误码解释添加10016
- 修改说明文档,去除获取身份证返照接口
# 2018-03-02(1.0.1)
该版本升级内容:
- 添加说明文档
- 修改系统错误提示
← 介绍 PKI云服务 Java SDK →